Enviar Mensagem

Enviar uma mensagem para uma conversa. Ela é atribuída ao dono da API key e dispara os mesmos efeitos colaterais do compositor de mensagens do app — entrega de saída no canal da caixa de entrada, marcação de tempo da primeira resposta e tomada automática pela IA. Defina private: true para uma nota interna, que nunca é entregue ao contato. É obrigatório informar content ou ao menos um anexo. Toda operação é delimitada pelo workspaceId obrigatório. Uma API key com escopo de workspace que nomeie qualquer outro workspace é recusada com 403 antes de qualquer consulta rodar, então uma API key de workspace só consegue alcançar o próprio workspace.

POST/api/v1/chat/conversations/{conversationId}/messages

Authorization

apiKey
X-API-Key<token>

Sua API key do Studio, pessoal ou com escopo de workspace. Gere uma em Settings e depois API Keys. As operações que rejeitam API keys de workspace dizem isso na própria descrição.

Em: header

Parâmetros de path

conversationId*string

Conversa para a qual enviar.

Tamanho1 <= length

Corpo da requisição

application/json

O texto, o tipo, a visibilidade e os anexos da mensagem.

Definições TypeScript

Use o tipo request body no TypeScript.

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://agent-studio.seeyu.ai/api/v1/chat/conversations/string/messages" \  -H "X-API-Key: YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "workspaceId": "string"  }'
{
  "message": {
    "id": "msg_01J9M4Q0X6RA",
    "conversationId": "conv_01J9M4Q0X6R7",
    "content": "Thanks, that fixed it!",
    "messageType": "outgoing",
    "private": false,
    "contentType": "text",
    "senderType": "User",
    "senderId": "cnt_01J8F2K3N5P9",
    "attachments": [],
    "inReplyToId": null,
    "contentAttributes": null,
    "status": null,
    "createdAt": "2026-08-28T14:22:05.000Z"
  }
}
{
  "error": "Invalid input: expected string, received undefined",
  "details": [
    {
      "code": "invalid_type",
      "expected": "string",
      "path": [
        "phone"
      ],
      "message": "Invalid input: expected string, received undefined"
    }
  ]
}
{
  "error": "Unauthorized"
}
{
  "error": "API key is not authorized for this workspace"
}
{
  "error": "Conversation not found"
}
{
  "error": "Rate limit exceeded",
  "message": "API rate limit exceeded. Please retry after 2026-09-13T12:00:00.000Z",
  "retryAfter": 1789286400000
}
{
  "error": "Internal server error",
  "requestId": "req_01J9Z2K3M4N5P6Q7R8S9T0"
}
GETListar MensagensPOSTCriar Contato