Atualização do canal WhatsApp - Check Contact

Índice:

1. Introdução
2. Verificação da conta do usuário no WhatsApp pelo "/accounts
3. Requisição
4. Resposta

Introdução

Por decisão da Meta, o check contact, que permitia aos usuários do Blip checar a validade dos números de telefone de sua base de clientes no WhatsApp, está sendo descontinuado. Assim, os clientes On-Premise não terão, na versão atualizada do canal, acesso ao recurso. Eles terão de seguir, também por decisão da Meta, o mesmo padrão daqueles que utilizam a infraestrutura de Cloud API, que já não contavam com essa funcionalidade. 

O check contact permitia à pessoa usuária testar a validade de um número de telefone. O WhatsApp retornava informando se aquele contato era existente ou não. Na nova versão do canal, deixou-se de informar esse status. Independentemente de o usuário ter ou não WhatsApp, a resposta é sempre retornada com valid para status e um wa_id.

Isso tudo exige mais responsabilidade dos nossos clientes para garantir que o contato esteja correto. Você vai continuar a ter visibilidade das mensagens que não são entregues, mas não poderá desfazer a ação de envio de uma mensagem para um contato inexistente. 

Observação: A chamada para o /accounts deve ser realizada antes de qualquer envio de notificações via API do Blip, independente da versão do container que o bot esteja ou em Cloud API. Pois a chamada ao /accounts evita que a thread do contato seja duplicada. A principal diferença é que agora as novas versões dos container terão comportamento semelhante ao CAPI, onde o número não é mais validado pela Meta, conforme mencionado acima.

Verificação da conta do usuário no WhatsApp pelo "/accounts"

O processo de verificação deve ser realizado para todo envio de mensagens e notificações. Mesmo em casos de números já validados, o WhatsApp não garante uma cache de mais de 7 dias. Isso pode levar seu envio a receber um erro de contato inexistente na base do container do WhatsApp. Esta definição de cache e usuários válidos está descrita na Documentação Oficial do WhatsApp.

Requisição

A plataforma do Blip se encarregará de chamar o WhatsApp e realizar a validação, retornando os dados daquele contato no WhatsApp. A chamada para validar usuário pela API da Blip é a seguinte:

YOUR_TOKEN é a chave de autorização do seu bot.

PHONE_NUMBER é o número do usuário a ser validado. Ele deve estar na sua forma completa com +, DDI, DDD e o número.

Ponto de atenção: Não se esqueça de adicionar o sinal de "+" (mais) antes de enviar.

Exemplo: +5531988889999. 

POST https://{ORGANIZATION_ID}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}

{
"id": "{{$guid}}",
"to": "postmaster@wa.gw.msging.net",
"method": "get",
"uri": "lime://wa.gw.msging.net/accounts/{PHONE_NUMBER}"
}

No caso de requisições em lote:

POST https://{ORGANIZATION_ID}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}

{
"id": "{{$guid}}",
"to": "postmaster@wa.gw.msging.net",
"method": "get",
"uri": "lime://wa.gw.msging.net/accounts?identities=+5531988889999;+5531966667777"
}

Observação: Certifique-se de colocar o caracter “+” antes de cada número.

Resposta

Na resposta desta chamada haverá algumas informações do contato. Aqui a mais importante delas é o alternativeAccount, que deve ser utilizado para o disparo da notificação. Após a validação, é fundamental salvar o valor retornado neste campo. Os outros campos são informações extras e que nem sempre estarão disponíveis, a depender do contato.

Exemplo: 5531988889999@wa.gw.msging.net.

HTTP/1.1 200 OK

Content-Type: application/json

{

    "type": "application/vnd.lime.account+json",

    "resource": {

        "fullName": "John Doe",

        "alternativeAccount": "5531988889999@wa.gw.msging.net",

        "identity": "5531988889999@wa.gw.msging.net",

        "phoneNumber": "+5531988889999",

        "source": "WhatsApp"

    },

    "method": "get",

    "status": "success",

    "id": "{{$guid}}",

    "from": "postmaster@wa.gw.msging.net",

    "to": "bot@msging.net",

    "metadata": {

        "#command.uri": "lime://wa.gw.msging.net/accounts/+5531988889999"

    }

}

Observação: No envio de message templates não será mais necessário utilizar o campo Namespace.

Por isso, é importante a sua remoção para evitar qualquer inconsistência no futuro.

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃