Sua primeira mensagem

Enviar um texto

curl -X POST https://developers.wasync.app/api/v1/messages \
  -H "Authorization: Bearer $WASYNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"connectionId":"conn_8f3a21","to":"40700000000","text":"Hi from my app 👋"}'

{
  "messageId": "cmqj3k2ab0001xyz",
  "waMessageId": "[email protected]_3EB0A1B2C3",
  "status": "sent"
}

to aceita apenas dígitos no formato internacional, sem + — por exemplo, 40700000000. text tem no máximo 4096 caracteres. Para mídia, envie media em vez de text: { filename, mimetype, data (base64, ≤ 16 MB), caption? } — exatamente um dos dois. Notas de voz usam mimetype: audio/ogg e um nome de arquivo voice-*.ogg. Usa whatsapp.send.

Dois ids — use o certo para relacionar

A resposta traz dois identificadores, e eles não são intercambiáveis.

Vale tratar um caso degradado no código: { "messageId": null, "waMessageId": "…", "status": …, "persisted": false } com HTTP 200 significa que a mensagem foi entregue, mas não foi persistida. Não tente de novo.

Ler a conversa de volta

curl "https://developers.wasync.app/api/v1/messages?connectionId=conn_8f3a21&limit=20" \
  -H "Authorization: Bearer $WASYNC_API_KEY"

{
  "messages": [
    {
      "id": "cmqj3k2ab0001xyz",
      "waMessageId": "[email protected]_3EB0A1B2C3",
      "connectionId": "conn_8f3a21",
      "direction": "outgoing",
      "text": "Hi from my app 👋",
      "mediaUrl": null,
      "mediaType": null,
      "status": "delivered",
      "errorMessage": null,
      "createdAt": "2026-07-22T10:00:00.000Z"
    }
  ],
  "nextCursor": "cmqj3k2ab0001xyz",
  "hasMore": true
}

As mais recentes vêm primeiro, com paginação por cursor: limit vai de 1 a 100 (padrão 20), e cursor recebe o nextCursor da resposta anterior. Usa whatsapp.read.

Deixe o cliente com os tiques azuis

curl -X POST https://developers.wasync.app/api/v1/messages/read \
  -H "Authorization: Bearer $WASYNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"connectionId":"conn_8f3a21","phone":"40700000000"}'

Chame este endpoint quando um operador abrir a conversa na sua interface — caso contrário, ninguém abre o chat no WhatsApp, as mensagens do cliente continuam com dois tiques cinza e a conversa parece ignorada. O corpo é { connectionId, phone?, messageId? }, com pelo menos um entre phone / messageId (o cuid de uma mensagem recebida; messageId prevalece quando os dois são informados). Usa whatsapp.send, e não whatsapp.read, porque transmite um recibo de leitura ao cliente. É idempotente, sem chave e sem limite de requisições. Retorna { "ok": true, "marked": 3 }.

Próximos passos

• Seja avisado sobre mensagens recebidas em vez de fazer polling: Webhooks.
• Monte tudo sem código: n8n ou MCP.
• Gere um cliente a partir do contrato: npx @openapitools/openapi-generator-cli generate -i https://developers.wasync.app/openapi.json -g typescript-fetch -o ./wasync-client