OPT Juntos
  1. Mensagens
OPT Juntos
  • OPT waba
    • Como enviar mensagens
    • Mensagens
      • Áudio
        POST
      • Contato
        POST
      • Documento
        POST
      • Imagem
        POST
      • Interativa com chamada para ação (URL)
        POST
      • Interativa com lista
        POST
      • Interativa com botões
        POST
      • Localização
        POST
      • Figurinha
        POST
      • Texto
        POST
      • Vídeo
        POST
      • Reação
        POST
      • Confirmação de leitura
        POST
    • Modelos de mensagens
      • Texto
      • Imagem
      • Documento
      • Vídeo
      • Botões
      • Lista
      • Localização
      • Código OTP
    • Mídia
      • Obter mídia
  • OPT Bot
    • send message to bot
      GET
  1. Mensagens

Confirmação de leitura

POST
https://waba.optjuntos.com.br/api/v1/messages

✅ Marcar Mensagem como Lida#

A funcionalidade de marcar mensagem como lida permite que sua aplicação notifique ao remetente que você visualizou a mensagem, exibindo o ícone de confirmação de leitura (duplo check azul) no WhatsApp do usuário.
Exemplo de mensagem de texto no WhatsApp

Como obter o message_id#

O message_id é necessário para marcar uma mensagem como lida. Você pode obtê-lo a partir da notificação webhook que você recebe quando um usuário envia uma mensagem:
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "PHONE_NUMBER",
              "phone_number_id": "PHONE_NUMBER_ID"
            },
            "contacts": [
              {
                "profile": {
                  "name": "CONTACT_NAME"
                },
                "wa_id": "CONTACT_PHONE_NUMBER"
              }
            ],
            "messages": [
              {
                "from": "CONTACT_PHONE_NUMBER",
                "id": "wamid.ID",  // Este é o message_id que você precisa
                "timestamp": "TIMESTAMP",
                "text": {
                  "body": "MESSAGE_BODY"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Boas práticas#

Marque as mensagens como lidas somente quando elas forem realmente visualizadas por um atendente ou processadas por seu sistema
Utilize esta funcionalidade para melhorar a experiência do cliente, indicando que sua mensagem foi recebida e visualizada
Considere o tempo entre o recebimento da mensagem e a marcação como lida para gerenciar expectativas do cliente
Implemente um sistema para rastrear quais mensagens foram marcadas como lidas para evitar repetições desnecessárias

Casos de uso comuns#

Confirmar visualmente ao cliente que sua mensagem foi recebida e visualizada pelo suporte
Indicar que um agente humano está revisando a solicitação do cliente
Marcar mensagens como lidas após o processamento automático por um chatbot
Sincronizar o status de leitura entre diferentes canais de atendimento

Limitações e considerações#

A confirmação de leitura só será visível se o usuário tiver ativado esta opção nas configurações de privacidade do WhatsApp
Você só pode marcar como lidas as mensagens recebidas pelo seu número de telefone WhatsApp Business
A chamada de API para marcar mensagens como lidas pode levar alguns segundos para refletir no dispositivo do usuário
Não é possível desfazer a marcação de leitura uma vez que a mensagem foi marcada como lida

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Bodyapplication/json

Exemplo
{
    "messaging_product": "whatsapp",
    "message_id": "{{message_id}}"
}

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://waba.optjuntos.com.br/api/v1/messages' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messaging_product": "whatsapp",
    "message_id": ""
}'

Respostas

🟢200OK
application/json
✅ Confirmação de leitura enviada com sucesso
Body

Exemplo
{
    "success": true
}
🟠400Pedido inválido
🟠401Não autorizado
🟠404Registro não encontrado
🔴500Erro do servidor
Modificado em 2025-04-08 07:06:09
Página anterior
Reação
Próxima página
Modelos de mensagens
Built with