# Criar conversa com agente

Criar conversa com agente. Consulte abaixo parâmetros, corpo da requisição e respostas definidos no contrato OpenAPI.

Source: https://zild.ai/pt-BR/docs/api-reference/post-api-Agent-conversation

POST `/Agent/conversation`

Criar conversa com agente. Consulte abaixo parâmetros, corpo da requisição e respostas definidos no contrato OpenAPI.

**Descrição no OpenAPI:** This endpoint creates a new conversation between a user and the agent.

## Autenticação

**Autenticação obrigatória.** Envie sua chave de API de usuário no header X-API-Key.

## Parâmetros

Esta operação não possui parâmetros de rota, query ou header.

## Corpo da requisição

**Content type:** `application/json` · **Schema:** `AgentConversationRequestDto`



<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>agentId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>inputMessage</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>messageType</code></td><td><code>MessageType</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>mediaFileName</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>mediaUrl</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>documentId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>



## Exemplo de requisição



```
curl --request POST \
  --url 'https://api.zild.ai/Agent/conversation' \
  --header 'X-API-Key: YOUR_USER_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "agentId": 0,
  "inputMessage": "string",
  "messageType": 0,
  "mediaFileName": "string",
  "mediaUrl": "string",
  "documentId": 0
}'
```



## Respostas



<table class="api-params"><thead><tr><th>Status</th><th>Descrição</th><th>Corpo da resposta</th></tr></thead><tbody><tr><td><code>200</code></td><td>Conversation created successfully</td><td>Nenhum corpo de resposta está definido.</td></tr></tbody></table>



## Modelos de dados

`AgentConversationRequestDto`

<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>agentId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>inputMessage</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>messageType</code></td><td><code>MessageType</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>mediaFileName</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>mediaUrl</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>documentId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>

`MessageType`0 = Text; 1 = Image; 2 = File; 3 = Audio; 4 = Video; 5 = Internal; 6 = TemplateMarketing; 7 = TemplateUtility; 8 = Location; 9 = Contact

`integer`