Pular para o conteúdo principal
Todos os endpoints de envio exigem uma sessão conectada e autenticada.
token: YOUR_TOKEN
Content-Type: application/json
A maioria dos endpoints de envio retorna um ID de mensagem gerado. Armazene este ID se você quiser editar, excluir, reagir ou inspecionar a mensagem posteriormente.

Campos comuns

CampoSignificado
Phone / phoneNúmero de telefone do destinatário ou JID.
Body / bodyConteúdo principal do texto.
IdID de mensagem do WhatsApp personalizado opcional. Se omitido, o WaGo gera um.
ForwardMarca uma mensagem como encaminhada onde suportado.
ContextInfoContexto opcional de mensagem citada para respostas.

Texto

curl -X POST http://localhost:1337/send/text \
  -H "Content-Type: application/json" \
  -H "token: YOUR_TOKEN" \
  -d '{
    "Phone": "15551234567",
    "Body": "Hello from WaGo"
  }'
Campos obrigatórios: Phone, Body.

Imagem

POST /send/image envia uma URL de dados de imagem em base64.
{
  "Phone": "15551234567",
  "Image": "data:image/jpeg;base64,/9j/4AAQ...",
  "Caption": "Invoice photo"
}

Áudio

POST /send/audio envia áudio. Use um payload de URL de dados. Para o comportamento de nota de voz, verifique os campos do comportamento atual do endpoint, pois o comportamento do áudio depende dos campos do payload nessa requisição.

Documento

POST /send/document requer:
{
  "Phone": "15551234567",
  "Document": "data:application/octet-stream;base64,JVBERi0x...",
  "FileName": "invoice.pdf",
  "Caption": "Invoice",
  "Mimetype": "application/pdf"
}
O comportamento atual do endpoint espera que a URL de dados do documento comece com data:application/octet-stream;base64,.

Vídeo

POST /send/video envia uma URL de dados de vídeo em base64 com legenda opcional.

Sticker

POST /send/sticker envia um payload de sticker em base64. Use uma imagem compatível com o WhatsApp ou um payload webp.

Enquete

{
  "Phone": "15551234567",
  "Question": "Pick one",
  "Options": ["A", "B"],
  "MaxAnswer": 1
}
Options deve conter pelo menos duas escolhas.

Localização

POST /send/location envia latitude e longitude. Use isso para mensagens de localização estática, não localização em tempo real.

Contato

POST /send/contact envia uma mensagem de contato vCard. O servidor constrói um payload de contato do WhatsApp a partir dos campos da requisição.

Convite de grupo e pré-visualizações

EndpointUso
POST /send/groupinviteEnvia uma mensagem de pré-visualização no estilo de convite de grupo.
POST /send/previewEnvia uma pré-visualização de link com metadados de miniatura carregados.
POST /send/preview2Envia uma pré-visualização no estilo de resposta a anúncio usando contexto de resposta a anúncio externo.

URL de mídia direta

POST /send/mediaurl permite que o WaGo baixe mídia de uma URL e a envie. O servidor WaGo deve ser capaz de acessar a URL. Use isso quando seu aplicativo armazena arquivos fora do WaGo e não deseja codificar mídias grandes em base64 dentro do JSON.

Referência completa de campos

Cada endpoint de envio e campo de corpo está listado em Referência completa de endpoints.