---
title: "Send a message"
method: POST
path: "/v1/messages/send"
tags: ["v1Messages"]
---

# Send a message

`POST /v1/messages/send`

Queues a message to a phone number through one of the workspace channels. Official WhatsApp channels (with waba_id) require a `template` for contacts outside the 24h window. Use the returned id with GET /v1/messages/queue/{id} to track delivery.

## Request body

- SendMessagePublicDto
  - `channelId` number, required — Id do canal de envio
  - `to` string, required — Telefone no formato DDI+DDD+NUMERO (apenas dígitos). Caracteres não numéricos são removidos.
  - `message` string — Texto da mensagem. Obrigatório quando não há `template` nem `callOptions`.
  - `hidden` boolean — Quando true, a conversa não é aberta para os atendentes (fica oculta/resolvida).
  - `isMedia` boolean — Quando true, `message` é tratada como URL de mídia.
  - `callOptions` SendMessageCallOptionsDto
    - `setGroupId` number — Id do grupo que receberá a conversa
    - `execAutoAttributionId` number — Id da regra de atribuição automática a executar
    - `execBotId` number — Id do bot a executar após o envio
    - `contact` SendMessageContactDto
      - `name` string
      - `email` string
    - `doInternationalValidation` boolean — Quando true, aceita números internacionais fora do padrão 55DDDNUMERO
  - `template` SendMessageTemplateDto
    - `id` string — Id do template na Meta
    - `name` string
    - `language` string
    - `components` object[] — Componentes do template no formato da Meta. Opcional quando `id` é informado.
    - `bodyFields` string[] — Valores das variáveis {{1}}, {{2}}... do corpo do template, em ordem
  - `executeAt` string — Agenda o envio para a data informada (ISO 8601).
  - `externalId` string — Identificador externo idempotente. Uma segunda chamada com o mesmo valor retorna 409.

## Response `201`

- SendMessageResponseDto
  - `id` number, required — Id da mensagem na fila. Use em GET /v1/messages/queue/{id}.
  - `queued` boolean, required

## Changes

- **2026-09-10** `a43da5bbb5f5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kinbox/apis/kinbox-api/changes/v1/messages/send/post.md)

---

[API](https://skmtc.dev/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.dev/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinbox/apis/kinbox-api/revisions/c083bbfe8973?raw)