Enviar uma mensagem de texto

Texto livre é um dos três modos mutuamente exclusivos do único endpoint de envio — não existe um endpoint separado /messages/text:

POST https://pilotstatus.com.br/v1/messages/send

Requisição

Autentique com sua chave de API com escopo de número no header x-api-key.

string

obrigatório

Telefone de destino em E.164 com + inicial (ex.: +5511999999999).

string

obrigatório

Corpo da mensagem de texto livre. Mutuamente exclusivo com templateId e com mídia direta (media + mediaType).

string

Data e hora ISO 8601 opcional para agendar o envio.

curl -X POST "https://pilotstatus.com.br/v1/messages/send" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ps_sua_chave_aqui" \
  -d '{
    "destinationNumber": "+5511999999999",
    "text": "Oi! Sua entrega foi confirmada para amanhã."
  }'

Resposta (202)

{
  "id": "msg_abc",
  "correlationId": "corr_123",
  "status": "QUEUED"
}

O id do 202 é o mesmo valor de data.id nos webhooks de entrega (message.sent, message.delivered, message.read, message.failed) — veja Eventos de webhook. O correlationId é gerado pela plataforma e se repete nos eventos correlacionados.

Observações

Texto livre não usa template — nada precisa ser aprovado antes.
Em números Meta Cloud API, texto livre só funciona dentro da janela de conversa de 24h do WhatsApp; fora dela o envio falha de forma assíncrona com META_OUTSIDE_24H_WINDOW no webhook message.failed — use um template aprovado em vez disso.
Para a lista completa de parâmetros (destinos, agendamento, labels, botões, header/footer), veja Enviar uma mensagem.

Visão Geral

Mensagens

Modelos

Números

Conversas & Dados

Webhooks

Chamadas de Voz

Camada de Compatibilidade

Conta & Cobrança

Marca & Incorporação

Enviar uma mensagem de texto — POST /v1/messages/send

Enviar uma mensagem de texto

Requisição

Resposta (202)

Observações

​Enviar uma mensagem de texto

​Requisição

​Resposta (202)

​Observações

Enviar uma mensagem de texto

Requisição

Resposta (202)

Observações