Consultar Resposta do WhatsApp

Este método é utilizado para consultar o estado da validação enviada para uma transação na Plataforma Data Trust.

📘

Endereço dos nossos serviços:

Homologação: GET https://datatrustapihml.clearsale.com.br/v1/transaction/{id}/whatsapps/2fa
Produção: GET https://datatrustapi.clearsale.com.br/v1/transaction/{id}/whatsapps/2fa

Acesse aqui a documentação técnica

👍

Qualquer consulta via método GET não tem cobrança!

Para realizar o GET e obter um resultado é necessário ter sido realizado o POST no módulo da Plataforma Data Trust.

Dicionário de variáveis

Reply

NomeDescriçãoTipo
OptionResposta do WhatsApp 2FA (1, 2 ou 3)Int
RepliedAtData da Resposta da ValidaçãoDatetime

As respostas possíveis para o módulo de 2FA são:

1 - Sim

2 - Não

3 Não sou {fulano}

Message - Mensagem de erro em caso de status "Failed"

NomeDescriçãoTipo
idCódigo do erroInt
errorDescrição do erroString

Possíveis erros retornados

131026 – Message undeliverable (Mensagem Não Entregue)

Esse erro ocorre quando uma mensagem enviada via API do WhatsApp não é entregue ao destinatário. Não é uma falha técnica no servidor, mas sim uma rejeição pelo destinatário ou pela plataforma Meta.

Principais causas:

  • Número inválido: O destinatário não tem conta ativa no WhatsApp ou o número foi desativado.
  • Bloqueio: O usuário bloqueou o número comercial.
  • Opt-out: O destinatário saiu do serviço.
  • Termos e Políticas: O usuário não aceitou os Termos de Serviço ou Política de Privacidade mais recentes.
  • Versão desatualizada do WhatsApp: O destinatário usa uma versão antiga que não suporta recursos modernos.
  • Android: 2.21.15.15 ou superior
  • iOS: 2.21.170.4 ou superior
  • Web: 2.2132.6 ou superior
  • Limite de frequência (Marketing): O WhatsApp limita mensagens para evitar spam.

131049 – Healthy Ecosystem

Esse erro acontece quando uma empresa tenta enviar mensagens de marketing pelo WhatsApp, mas a mensagem não é entregue. O motivo? O WhatsApp limita a quantidade de mensagens promocionais que um usuário pode receber para evitar excesso e manter uma experiência saudável.

Por que isso ocorre?

Se um usuário já recebeu muitas mensagens de marketing (de várias empresas) em um período, o WhatsApp bloqueia novas mensagens para ele. Esse limite não é fixo; varia conforme o histórico do usuário, como quantidade de mensagens recebidas e se ele respondeu às anteriores. Qual é a intenção da Meta? Proteger os usuários contra spam e melhorar a qualidade das interações. Isso aumenta a chance de engajamento e evita que as pessoas se sintam incomodadas. O que significa para sua empresa? O erro indica que seus envios estão sendo considerados excessivos ou pouco relevantes. Isso pode acontecer por:

  • Alto volume de mensagens sem resposta
  • Repetição sem interação
  • Uso massivo de templates com baixo engajamento
  • Falta de segmentação ou envio para contatos “frios”

Importante: Não é um problema técnico. É uma regra do WhatsApp para manter um “ecossistema saudável”.