Recursos

Mensagens completas, na API oficial do WhatsApp.

Texto, mídia, áudio, templates aprovados, mensagens interativas, agendamento e o ciclo de vida completo de cada mensagem — tudo via REST, na WhatsApp Business Platform oficial.

Teste grátis por 30 dias. Cancele quando quiser.

Tudo o que sua operação envia e recebe.

Texto, mídia, áudio, templates, mensagens interativas, agendamento e idempotência.
Com eventos em tempo real para cada etapa do ciclo de vida.

Texto, reply e edição

Envie mensagens com contexto real: respostas, edições, citações e formatação nativa do WhatsApp. Acompanhe cada etapa da conversa com status de envio, entrega e leitura em tempo real.

Cada mensagem é rastreável do envio à leitura, com eventos em tempo real.

api.catcher.one/api/v1/messages/text
POST /v1/messages/text

Content-Type: application/json

Idempotency-Key: k_8a3f2c91

{

"to": "5511999991234",

"text": "Olá! Em que posso ajudar?",

"quoted_id": "msg_a1b2c3"

}

↳ 202 Accepted

message_id: "msg_b4d2f1"

Imagem, vídeo e sticker

Envie imagens, vídeos, GIFs e stickers em todos os formatos aceitos pelo WhatsApp.

Upload rápido, preview nativo e suporte aos formatos usados no dia a dia da operação.

api.catcher.one/api/v1/messages/image
POST /v1/messages/image

"to": "5511…",

"media_url": "https://cdn.minhaloja.com/produtos/foto.jpg",

"caption": "Confira nossa nova coleção"

image

JPG · PNG · GIF · WebP

video

MP4 · MOV

sticker

WebP estático/animado

↳ 202 Accepted · media cached em 380ms

media_id: "med_x9y8z7"

Áudio PTT

Envie mensagens de voz com waveform igual ao original.

O destinatário vê como áudio de voz nativo, com forma de onda visível, play/pause inline. A conversão preserva qualidade e duração, do jeito que o destinatário espera receber.

api.catcher.one/api/v1/messages/audio
0:23
inputaudio.mp3 · 192kbps
outputopus · 16kHz · mono
duration23.4s
waveform64 samples

Documento

PDF, DOC, XLS, ZIP, CSV e qualquer outro arquivo, com preview e nome personalizado.

Aceita URL ou upload multipart, idêntico aos demais endpoints de mídia.

api.catcher.one/api/v1/messages/document
PDF

NFe-2026-05-1247.pdf

218 KB

Sua nota fiscal está anexada. Qualquer dúvida estamos à disposição.

"filename":"NFe-2026-05-1247.pdf"
"media_url":"https://.../nfe.pdf"
"caption":"Sua nota fiscal…"

Localização e contato

Envie localização em tempo real com mini-mapa no WhatsApp do destinatário.

Cartões de contato (vCard) com nome, telefone e qualquer campo padrão.

api.catcher.one/api/v1/messages/location

Rua das Flores, 142

São Paulo, SP · -23.5505, -46.6333

"lat":-23.5505
"lng":-46.6333
"label":"Rua das Flores, 142"

Reação, enquete e template

Reações com emoji em mensagens enviadas ou recebidas. Crie enquetes com até 12 opções, com escolha única ou múltipla escolha com identificação do usuário.

Envie templates com botões interativos: call-to-action, resposta rápida e links.

api.catcher.one/api/v1/messages/poll

Qual horário fica melhor?

10h às 12h 8 votos · 47%
14h às 16h 5 votos · 29%
16h às 18h 4 votos · 24%

17 votos · escolha única

👍 12 ❤️ 8 🎉 3

Encaminhamento e exclusão

Encaminhe mensagens, remova conteúdos enviados e mantenha compatibilidade com os comportamentos nativos do WhatsApp, pela API oficial.

Cada encaminhamento guarda a origem da mensagem, e cada exclusão registra quando e por quem foi feita. Pronto pra qualquer auditoria.

api.catcher.one/api/v1/messages/forward
encaminhada

Reunião confirmada pra amanhã às 14h, sala 3

→ 5511… (3 destinos) · 14:28

mensagem apagada

Esta mensagem foi apagada

deleted_for_everyone · 14:32 (1h42m após envio)

audit chain

orig msg_a1b2c3 → fwd msg_b4d2f1 → del 2026-05-17 14:32

Agendamento nativo

Agende mensagens com data e hora futuras com fuso-horário, podendo cancelar com até 30s antes do envio.

api.catcher.one/api/v1/messages/schedule
Próximo envio

amanhã, 09:00

em 18h 27min · 5541… · texto

Bom dia! Lembrete da sua consulta amanhã às 14h…

Fila de agendados

amanhã 09:00 · 5541… texto
amanhã 10:30 · 5521… image
sex 14:00 · 5511… poll

Proteção contra mensagens duplicadas

Reenvios acidentais não viram mensagem duplicada para o destinatário. Se sua aplicação tentar enviar a mesma mensagem duas vezes, por falha de rede, duplo-clique ou retry automático, a Catcher reconhece e devolve a mesma resposta, sem disparar de novo.

Funciona em todos os envios, sem configuração extra. Cada tentativa fica registrada no log para auditoria.

api.catcher.one/api/v1/messages/*

Request 1 · 14:32:18

POST /v1/messages/text

Idempotency-Key: k_8a3f2c91

↳ 202 Accepted · msg_b4d2f1

retry de rede

Request 2 · 14:32:19 (mesma key)

POST /v1/messages/text

Idempotency-Key: k_8a3f2c91

↳ 202 Accepted · msg_b4d2f1 (replay)

Idempotency-Replayed: true

✓ zero envio duplicado

Rastreabilidade completa da operação

Saiba exatamente o que aconteceu com cada mensagem: envio, entrega, leitura, falha. Com registro de timestamp.

Tudo observável via webhooks e interface operacional.

api.catcher.one/events?msg_id=msg_b4d2f1
Lifecycle msg_b4d2f1
queued 14:32:18.042
sent 14:32:18.467 (+425ms)
delivered 14:32:19.103 (+636ms)
read 14:34:02.847 (+1m43s)

✓ entregue em 1.06s · lida em 1m44s

timeline persistida no tenant DB

Pronta pra construir hoje.
Estável pra escalar amanhã.

Teste 30 dias grátis e cancele quando quiser.