Enviar mensagem é só metade do trabalho. Aplicações de atendimento sérias precisam reagir, corrigir um erro de digitação, apagar uma mensagem enviada por engano, fixar um aviso importante no topo da conversa e encaminhar conteúdo entre contatos. Tudo isso é possível via API REST — e este artigo mostra cada ação com o endpoint exato.
As ações operam sobre uma mensagem já existente, identificada pelo seu messageId (o ID que a API retorna no envio, ou que chega no webhook message.received).
Reagir com emoji
POST /v1/instances/{id}/messages/{messageId}/react
{ "emoji": "👍" }Para remover a reação, envie um emoji vazio. Reações são ótimas para confirmar leitura de forma leve em fluxos automatizados ("recebemos seu pedido 👍").
Editar uma mensagem enviada
PUT /v1/instances/{id}/messages/{messageId}
{ "newText": "Texto corrigido" }O WhatsApp permite editar mensagens recentes (janela de tempo limitada pelo próprio app). Útil para corrigir um link errado sem poluir a conversa com "* corrigindo".
Apagar (para todos)
DELETE /v1/instances/{id}/messages/{messageId}
{ "forEveryone": true }Apaga a mensagem para todos os participantes (aparece "Esta mensagem foi apagada"). Sem forEveryone, apaga só do seu lado.
Fixar no topo
POST /v1/instances/{id}/messages/{messageId}/pin
{ "duration": 86400 }Fixa a mensagem no topo da conversa pelo tempo (em segundos) informado. Bom para destacar um aviso ou link de pagamento durante uma negociação.
Encaminhar
POST /v1/instances/{id}/messages/{messageId}/forward
{ "toPhone": "5511988887777" }Marcar como lida
POST /v1/instances/{id}/messages/read
{ "phone": "5511999998888", "messageIds": ["ABC123", "DEF456"] }Marcar como lida programaticamente evita o "azulzinho" inconsistente quando você processa mensagens por API e quer sinalizar ao cliente que a mensagem foi vista.
messageId de toda mensagem que você envia (e dos webhooks de entrada). Sem ele, nenhuma ação acima é possível. Uma tabela simples messageId → contexto resolve.
Comece em minutos, sem aprovação da Meta
Crie uma instância, conecte o WhatsApp lendo um QR Code e faça o primeiro envio via API REST. Trial de 7 dias, sem cartão.
Criar conta grátisPerguntas frequentes
Tem janela de tempo para editar/apagar? Sim, o próprio WhatsApp limita (poucos minutos para editar, mais tempo para apagar). A API repassa o limite do app.
Posso reagir a uma mensagem que recebi? Sim — use o messageId que chegou no webhook message.received.
E se eu não tiver guardado o messageId? Ações exigem o ID. Se a mensagem é antiga e você não o armazenou, não há como referenciá-la.
Apagar para todos sempre funciona? Funciona dentro da janela do WhatsApp; passou o prazo, só apaga do seu lado.