Atualização da API do WhatsApp: Direct Send e Request Contact Info

Em outubro, a API do WhatsApp ganhou duas funções novas. O Direct Send envia uma mensagem sem modelo. O Request Contact Info pede o número de telefone quando chega um BSUID, e não o telefone.

Direct Send

Para escrever primeiro para um cliente, você precisa criar um modelo e esperar a aprovação do WhatsApp. Na 1MSG isso já está resolvido: em cada canal, criamos um modelo automaticamente e enviamos a sua mensagem com esse modelo, então mais mensagens são entregues e há menos erros. O WhatsApp agora tem uma função parecida, chamada Direct Send.

O Direct Send permite escrever primeiro para um cliente com texto normal, sem o seu próprio modelo e sem esperar a aprovação. No envio, você define a categoria da própria mensagem como utility, e não a categoria de um modelo: o WhatsApp usa essa categoria para encontrar um modelo ou criar um. A documentação do Direct Send explica como o WhatsApp faz isso. Sem utility, o envio continua sendo uma mensagem de serviço normal e o Direct Send não é acionado.

O Direct Send ainda não está disponível para todas as empresas. Por enquanto, a Meta libera o recurso para portfólios comerciais com limite de mensagens de 100.000 ou sem limite, e um banner no WhatsApp Manager mostra se você tem acesso. Se você não tem acesso, pode pedir no mesmo lugar. Se o banner mostrar que o acesso já existe, não precisa ativar mais nada: uma mensagem com a categoria utility funciona na hora.

Para enviar essa mensagem na 1MSG, veja o método Enviar uma mensagem.

Request Contact Info

Neste ano, a Meta adicionou o BSUID: a pessoa pode criar um nome de usuário e ocultar o número de telefone da empresa. O chat chega então com um BSUID em vez do telefone, e você não consegue saber qual cliente é se conhece os seus clientes pelo número. O método novo Request Contact Info resolve esse problema.

O método envia ao cliente um pedido do número de telefone: uma mensagem separada enquanto a conversa está aberta, e um modelo de utilidade ou de marketing se a conversa já está fechada. Quando o cliente aceita, o número chega no webhook e fica salvo junto com o BSUID dele.

Os detalhes estão no método Pedir o número de telefone.