v1

latestOpenAPI 3.0.02026-07-26253547.8 KB

Message

Enviar mensagem

Envia uma mensagem para um contato existente.

post/v1/send/message

Request body

contactstring required

Chat/contact ID

contentstring required

Message content. Required for conversation; optional for media types.

messageType'conversation' | 'image' | 'video' | 'audio' | 'document' required

Message type

urlstring

URL for media messages (required for image, video, audio and document; ignored for conversation).

scheduledAtstring

Timestamp ISO para agendamento. Se vazio, disparo imediato.

noteboolean

Se true, grava como nota interna (type: NOTES, não dispara envio como mensagem de API). Se false ou omitido, mensagem de API como hoje.

Example request

{
  "contact": "aaaaaaaa-bbbb-cccc-dddd-111111111111",
  "content": "Mensagem de exemplo",
  "messageType": "conversation",
  "url": "https://example.com/storage/bucket/example-file.jpg",
  "scheduledAt": "2026-03-25T14:30:00Z"
}

Response

Mensagem enviada com sucesso

responsestring required

Response status

idstring uuid required

UUID do chat/contato (Chat.id), mesmo valor enviado em contact na requisição.

Example response

{
  "response": "Success",
  "id": "aaaaaaaa-bbbb-cccc-dddd-111111111111"
}