Como criar e enviar componente de Solicitação de Contato no WhatsApp no Blip – Blip | Blip Help

O Blip permite que você interaja de forma mais inteligente com seus clientes utilizando recursos nativos do WhatsApp. A funcionalidade de Solicitação de Contato permite enviar uma mensagem estruturada com um botão específico disponibilizado pela Meta para que o contato compartilhe os dados de contato dele com o seu contato inteligente de forma simples, automática e segura.

Neste artigo você aprenderá a criar esse componente em um modelo de mensagem e em mensagens interativas, e também a fazer o envio através de diferentes canais da nossa API e diretamente pelo Blip Studio/Builder.

Como enviar como modelo de mensagem

1. Criação do modelo

Para criar o modelo, você deve realizar uma requisição HTTP utilizando o comando abaixo:

{
   "id":"{{$guid}}",
   "from":"{{$botIdentity}}",
   "method":"set",
   "type":"application/json",
   "to":"postmaster@wa.gw.msging.net",
   "uri":"/message-templates",
   "resource":{
      "name":"{{nome do message template}}",
      "components":[
         {
            "type":"BUTTONS",
            "buttons":[
               {
                  "type":"REQUEST_CONTACT_INFO",
                  "text":"Share Contact Info"
               }
            ]
         },
         {
            "type":"BODY",
            "text":"{{Texto do corpo da mensagem}}"
         }
      ],
      "language":"pt_BR",
      "category":"{{UTILITY ou MARKETING}}"
   }
}

2. Limitações importantes da Meta na utilização do componente

Por se tratar de uma funcionalidade nativa do ecossistema da Meta, existem regras específicas que precisam ser seguidas rigorosamente para evitar a reprovação ou falha no envio do componente:

Estrutura fixa: A requisição PRECISA ter exatamente a estrutura JSON descrita acima. Qualquer propriedade ausente ou modificada fora do padrão ocasionará falha imediata.
Componente de Botão: O objeto dentro de buttons deve conter obrigatoriamente os valores "type":"REQUEST_CONTACT_INFO" e "text":"Share Contact Info". Não altere esses textos ou tipos, pois são uma imposição da própria Meta para esse recurso. A tradução do texto do botão é feita automaticamente pela própria Meta.
O que pode ser customizado: a única flexibilidade permitida na criação é o campo "text" dentro do componente "BODY" (onde fica a mensagem principal que o usuário lerá), a definição do idioma ("language") e a categoria ("category"), que pode ser definida como UTILITY ou MARKETING (podendo ser revisada posteriormente pela Meta).

Uso de Variáveis: Você pode utilizar variáveis dinâmicas (como {{1}}, {{2}}) normalmente dentro do texto do corpo (BODY). Para entender mais sobre a aprovação e boas práticas de variáveis, acesse o nosso Guia de criação e aprovação de Message Template no WhatsApp.

Como enviar via API

Se você preferir fazer o envio direto para um contato específico utilizando a API tradicional de envio de mensagem, formate o payload conforme o modelo estruturado abaixo:

{
   "id":"{{$guid}}",
   "to":"{{$userIdentity}}@wa.gw.msging.net",
   "type":"application/json",
   "content": {
        "type": "template",
        "template": {
            "language": {
                "policy": "deterministic",
                "code": "pt_BR"
            },
            "name": "{{nome do message template}}",
            "components": []
        },
        "templateContent": {
            "name": "{{nome do message template}}",
            "language": "pt_BR",
            "category": "{{UTILITY ou MARKETING}}"
        }
    }
}

Como usar dentro do Blip Studio/Builder

Também é possível incluir esse componente de solicitação em uma conversa no fluxo do seu contato inteligente utilizando o Blip Studio/Builder. Para isso é necessário utilizar o bloco de Conteúdo Dinâmico.

Se você ainda não está familiarizado com esse tipo de componente, recomendamos a leitura prévia do artigo Como usar conteúdo dinâmico.

Passo a passo no Builder

No bloco desejado do seu fluxo, adicione um novo componente de conteúdo do tipo Conteúdo Dinâmico.

Defina o campo Tipo como application/json.
No campo Valor do conteúdo, preencha com o seguinte JSON:

{
        "recipient_type":"individual",
        "type":"interactive",
        "interactive": {
            "type": "request_contact_info",
            "body": {
                "text": "Por favor, compartilhe seu contato para podermos continuar nossa conversa."
            },
            "action": {
                "name": "request_contact_info"
            }
        }
}

Limitações da Meta para o Conteúdo Dinâmico

Assim como na API, existem propriedades imutáveis de acordo com as especificações da Meta:

O valor de "type" dentro de "interactive" deve ser estritamente "request_contact_info".
O valor de "name" dentro de "action" deve ser obrigatoriamente "request_contact_info".
A alteração livre é permitida apenas no campo "text" contido no objeto "body", que representa o texto descritivo enviado ao contato.

Como verificar a origem do contato compartilhado no WhatsApp

⚠️ Os comportamentos abaixo representam o desenho atual da funcionalidade e podem evoluir até a disponibilização final.

Quando um usuário compartilha um contato através do componente do WhatsApp disponibilizado pela Meta, estamos adicionando metadados específicos à mensagem que permitem identificar a origem e o tipo do compartilhamento. Esses metadados são essenciais para diferenciar quando o usuário está compartilhando suas próprias informações de contato ou compartilhando o contato de outra pessoa.

Metadados Disponíveis

1. `#wa.sharedWaId`

Este metadado indica que a mensagem contém informações de identificação do número de telefone. Ele aparece como uma propriedade nova que confirma a presença de dados de WaId no contexto das mensagens. Será omitida caso o usuário ainda não tenha compartilhado seu contato.

É disponibilizado em todas as mensagens em que o WhatsApp fornece um WhatsApp ID (WaId).

2. `#wa.contactOrigin`

Esse metadado identifica a origem do compartilhamento de contato, permitindo distinguir quando o usuário compartilha suas próprias informações ou compartilha dados de terceiros.

Valores possíveis:

- `contact_request` - O usuário compartilhou suas próprias informações de contato (através de um botão REQUEST_CONTACT_INFO ou similar)

- `other` - O usuário compartilha o contato de outra forma que não seja via botão de CTA, por exemplo, pela agenda de contatos, podendo ser o dele próprio ou de outra pessoa.

Obs: Esse metadado é exibido apenas em mensagens do tipo contatos compartilhados.

Identificação do compartilhamento de contato

Quando uma mensagem de contato compartilhado contém tanto `#wa.sharedWaId` quanto `#wa.contactOrigin` com valor "contact_request", você pode confirmar que o contato compartilhado é do próprio usuário que está enviando a mensagem, pois mesmo sendo compartilhado por meio do CTA pelo qual o usuário compartilha a informação do seu contato, ele tem a opção de omitir o número de telefone. Dessa forma, só é possível confirmar que o contato compartilhado é o mesmo do usuário por ambas as informações.

Exibição do componente de Solicitação de Contato

Trazemos aqui algumas imagens para exemplificar como o componente de solicitação será exibido na thread da conversa:

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃