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
  • Esquemas
    • OPT waba
      • Responses and Errors
        • MessageResponse
        • BaseMessage
        • ErrorResponse
      • Mensagens
        • Áudio
        • Contato
        • Documento
        • Imagem
        • Interativa com chamada para ação (URL)
        • Interativa com lista
        • Interativa com botões
        • Localização
        • Figurinha
        • Texto
        • Vídeo
        • Reação
        • Confirmação de leitura
      • Modelos
        • HeaderTextComponent
        • TemplateLanguage
        • TextParameter
        • ImageParameter
        • DocumentParameter
        • VideoParameter
        • LocationParameter
        • ButtonParameter
        • HeaderMediaComponent
        • BodyComponent
        • ButtonComponent
        • FooterComponent
        • TextTemplate
        • MediaTemplate
        • InteractiveTemplate
        • LocationTemplate
        • OTPTemplate
        • TextTemplateMessage
        • MediaTemplateMessage
        • InteractiveTemplateMessage
        • LocationTemplateMessage
        • OTPTemplateMessage
  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}}"
}

Códigos de solicitaçã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 'Authorization: Bearer <token>' \
--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