Mensagens

Envie e receba mensagens dentro de conversas. Suporta texto, anexos, cards interativos e diferentes tipos de conteudo.

GET/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages

Retorna as mensagens de uma conversa, ordenadas cronologicamente.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`account_id`(path)	`integer`	Sim	ID numerico da conta
`conversation_id`(path)	`integer`	Sim	ID numerico da conversa

curl -s "https://chat.seudominio.com/api/v1/accounts/1/conversations/123/messages" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Lista de mensagens

json

{
  "payload": [
    {
      "id": 1001,
      "content": "Ola, preciso de ajuda!",
      "message_type": 0,
      "content_type": "text",
      "sender": {
        "id": 456,
        "name": "Joao Silva",
        "type": "contact"
      },
      "conversation_id": 123,
      "created_at": 1708000000
    },
    {
      "id": 1002,
      "content": "Claro! Como posso ajudar?",
      "message_type": 1,
      "content_type": "text",
      "sender": {
        "id": 1,
        "name": "Agente 1",
        "type": "user"
      },
      "conversation_id": 123,
      "created_at": 1708000060
    }
  ]
}

POST/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages

Envia uma nova mensagem em uma conversa. Pode ser texto, nota interna ou mensagem com anexo.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`account_id`(path)	`integer`	Sim	ID numerico da conta
`conversation_id`(path)	`integer`	Sim	ID numerico da conversa

Body

Nome	Tipo	Obrigatorio	Descricao
`content`	`string`	Nao	Texto da mensagem (opcional quando ha anexo)
`message_type`	`string`	Nao	Tipo: outgoing (padrao), incoming, activity
`private`	`boolean`	Nao	true para nota interna (nao visivel ao contato)
`content_type`	`string`	Nao	Tipo de conteudo: text, input_select, cards, form, article
`content_attributes`	`object`	Nao	Atributos extras para conteudos interativos
`attachments[]`	`file`	Nao	Arquivos anexos (multipart/form-data). Aceita multiplos.
`template_params`	`object`	Nao	Parametros de template (WhatsApp template messages)

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/conversations/123/messages" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Sua solicitacao foi registrada com o numero #4567.",
    "message_type": "outgoing"
  }'

200Mensagem criada

json

{
  "id": 1003,
  "content": "Sua solicitacao foi registrada com o numero #4567.",
  "message_type": 1,
  "content_type": "text",
  "private": false,
  "conversation_id": 123,
  "created_at": 1708000120
}

DELETE/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages/{message_id}

Marca uma mensagem como deletada. O conteudo e substituido por um placeholder e os anexos sao removidos — a mensagem em si permanece no historico.

Soft delete

Este endpoint nao remove o registro da mensagem. Ele substitui o content por um texto padrao de mensagem deletada, define content_attributes.deleted = true e remove os anexos. O conversation_id e message_id sao resolvidos dentro da conta autenticada.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`account_id`(path)	`integer`	Sim	ID numerico da conta
`conversation_id`(path)	`integer`	Sim	display_id da conversa (escopado a conta)
`message_id`(path)	`integer`	Sim	ID da mensagem (escopado a conversa)

bash

curl -X DELETE "https://chat.seudominio.com/api/v1/accounts/1/conversations/123/messages/1003" \
  -H "api_access_token: YOUR_TOKEN"

200Mensagem marcada como deletada

Tipos de Conteudo

Alem de texto simples, mensagens suportam conteudos interativos:

Tipo	Descricao
`text`	Mensagem de texto simples
`input_select`	Menu de opcoes para o contato selecionar
`cards`	Carrossel de cards com titulo, descricao e acoes
`form`	Formulario interativo para coleta de dados
`article`	Artigo da central de ajuda

Enviando Anexos

Para enviar arquivos, use multipart/form-data no lugar de JSON:

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/conversations/123/messages" \
  -H "api_access_token: YOUR_TOKEN" \
  -F "content=Segue o documento solicitado" \
  -F "message_type=outgoing" \
  -F "attachments[]=@/path/to/documento.pdf"

Formatos suportados

Imagens (PNG, JPG, GIF, WebP), documentos (PDF, DOC, XLS), audio e video. Tamanho maximo: 40MB por arquivo.