---
title: "POST /v2/agent/{agentId}/conversation"
method: POST
path: "/v2/agent/{agentId}/conversation"
---

# POST /v2/agent/{agentId}/conversation

`POST /v2/agent/{agentId}/conversation`

Permite conversar com o agente via API enviando texto, imagem ou áudio

## Path parameters

- `agentId` string, required

## Request body

- union
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `prompt` string, required — Texto para o agente responder
    - `callbackUrl` string — Caso seja informado, a chamada será assíncrona, quando o agente responder, ele vai chamar esse webhook com a resposta.
    - `onFinishCallback` string — Caso seja informado, será disparado um webhook sempre que o atendimento for finalizado.
    - `chatName` string — Você pode informar o nome do cliente caso já possua.
    - `chatPicture` string — Uma foto do cliente que será mostrada no chat de atendimento.
    - `phone` string — Número de whatsapp do cliente.
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `prompt` string, required — Texto para o agente responder
    - `image` string, required — URL da imagem
    - `callbackUrl` string — Caso seja informado, a chamada será assíncrona, quando o agente responder, ele vai chamar esse webhook com a resposta.
    - `onFinishCallback` string — Caso seja informado, será disparado um webhook sempre que o atendimento for finalizado.
    - `chatName` string — Você pode informar o nome do cliente caso já possua.
    - `chatPicture` string — Uma foto do cliente que será mostrada no chat de atendimento.
    - `phone` string — Número de whatsapp do cliente.
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `audio` string, required — URL do áudio
    - `callbackUrl` string — Caso seja informado, a chamada será assíncrona, quando o agente responder, ele vai chamar esse webhook com a resposta.
    - `onFinishCallback` string — Caso seja informado, será disparado um webhook sempre que o atendimento for finalizado.
    - `chatName` string — Você pode informar o nome do cliente caso já possua.
    - `chatPicture` string — Uma foto do cliente que será mostrada no chat de atendimento.
    - `phone` string — Número de whatsapp do cliente.
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `video` string, required — URL do vídeo
    - `prompt` string — Texto para o agente responder/caption do vídeo
    - `callbackUrl` string — Caso seja informado, a chamada será assíncrona, quando o agente responder, ele vai chamar esse webhook com a resposta.
    - `onFinishCallback` string — Caso seja informado, será disparado um webhook sempre que o atendimento for finalizado.
    - `chatName` string — Você pode informar o nome do cliente caso já possua.
    - `chatPicture` string — Uma foto do cliente que será mostrada no chat de atendimento.
    - `phone` string — Número de whatsapp do cliente.
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `document` string, required — URL do documento a ser enviado
    - `prompt` string — Texto para o agente responder/caption do documento
    - `callbackUrl` string — Caso seja informado, a chamada será assíncrona, quando o agente responder, ele vai chamar esse webhook com a resposta.
    - `onFinishCallback` string — Caso seja informado, será disparado um webhook sempre que o atendimento for finalizado.
    - `chatName` string — Você pode informar o nome do cliente caso já possua.
    - `chatPicture` string — Uma foto do cliente que será mostrada no chat de atendimento.
    - `phone` string — Número de whatsapp do cliente.

## Response `200`

Resposta do agente

- object
  - `message` string — Resposta do agente
  - `images` string[]
  - `audios` string[]
  - `documents` string[]

## Other responses

- `400` — Erro inesperado
- `403` — Erro de token

---

[API](https://skmtc.net/gptmaker/apis/openapi-gpt-maker.md) · [All operations](https://skmtc.net/gptmaker/apis/openapi-gpt-maker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gptmaker/openapi-gpt-maker/versions/bda09b3eba6e/schema)