Enviar Mensagem por WhatsApp

Este método é utilizado para criar uma validação de segundo fator de autenticação via WhatsApp e enviar mensagem via WhatsApp para o hotphone do dono do CPF enviado na transação da Plataforma Data Trust.**

📘

Endereço dos nossos serviços:

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

Acesse aqui a documentação técnica

O módulo 2FA tem retorno assíncrono, depende de ação do seu cliente para que se obtenha a resposta da mensagem. Primeiro faça a chamada do módulo (método POST) para que possamos enviar a mensagem ao seu cliente, depois, faça a consulta do resultado utilizando o método GET. Você também pode implementar um Webhook para ser notificado quando o resultado estiver pronto!

Dicionário de variáveis

NomeDescriçãoTipo
StatusStatus da Validação [Sent = Envio / Delivered = Entregue / Read = Lido / Failed = Fracassado / Replied = Resposta]String
CreatedAtData da Criação da ValidaçãoDatetime
ReplyObjeto da Resposta do WhatsApp 2FAReply
SendLimitLimite de envio por transaçãoInt
ExpirationTimeTempo máximo para respostaDatetime
TextMensagem de texto que o cliente ira receber*String

*Obs: cada "\r\n" no campo text corresponde a uma quebra de linha.

2º Fator de Autenticação WhatsApp - 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 {nome}

Campos Genéricos (genericFields)

A inclusão de campos genéricos foi pensada para que o cliente possa inserir nas mensagens de texto de 2FA (inicialmente somente via WhatsApp), variáveis que somente a empresa cliente tem acesso aos dados e que façam sentido para o entendimento do contexto da mensagem pelo seu cliente / consumidor.

Para o envio de campos genéricos para uso na mensagem de 2FA é necessário alinhamento prévio, para que então o campo passe a ser considerado no envio da transação.

Uma vez que os campos estejam mapeados, é possível adicionar uma máscara para validar o dado enviado, como por exemplo enviar somente letras, enviar uma data, um valor monetário, etc.

Se você tem interesse em enviar campos genéricos na mensagem de 2FA entre em contato com o [email protected]