Pular para o conteúdo principal

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

  • Atualizado

  1. Como enviar como modelo de mensagem

    1. Criação do modelo

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

  2. Como enviar via API

  3. Como usar dentro do Blip Studio/Builder

    1. Passo a passo no Builder

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

 

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.

 

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 😃

Artigos relacionados