Conecte seu número Twilio ao seu perfil do WhatsApp Business

Neste guia, vamos ajudá-lo a obter a aprovação do seu número de telefone da Twilio para usar no WhatsApp. Com ele você poderá receber e enviar mensagens do seu número Twilio pelo WhatsApp. Se você quiser usar um número que não seja Twilio, consulte este artigo.

Em resumo, você deve concluir as seguintes etapas para ativar seu número Twilio para WhatsApp:

1. Solicite acesso para ativar seus números Twilio para WhatsApp
2. Envie uma solicitação do WhatsApp Sender no console da Twilio
3. Aprove a Twilio para enviar mensagens em seu nome no console do Facebook Business Manager
4. Envie sua conta do Facebook Business Manager para verificação de negócios
5. (A Twilio conclui seu registro do WhatsApp Sender)

Uma observação para ISVs, SIs e fornecedores terceirizados

Este guia inclui instruções para empresas diretas e fornecedores terceirizados. Os fornecedores terceirizados incluem fornecedores de software independentes (ISVs) e integradores de sistemas (SIs) que estão implementando o WhatsApp em nome de outra empresa ou marca. Em cada etapa, procure o subtítulo Observação para fornecedores terceirizados para encontrar instruções específicas.

Para obter orientação adicional sobre a integração do WhatsApp ISV/SI, consulte Integração do WhatsApp com fornecedores independentes de Software (ISV) e Integradores de sistema (SI)

Visão geral do processo de registro

Antes de começar

Antes de começar, certifique-se de que sua empresa atenda aos critérios de elegibilidade para a API do WhatsApp Business.

Para conectar seu número Twilio à sua conta WhatsApp Business, tenha em mãos as seguintes informações:

• ID da conta do Facebook Business Manager: Se você ainda não tiver uma, siga as instruções do Facebook sobre como configurar uma conta Facebook Business Manager. O WhatsApp usa a conta do FB Business Manager para identificar sua empresa para proteger o ecossistema WhatsApp.
• Conta Twilio: Você precisa do SID da sua conta Twilio, que pode ser encontrado no console da Twilio. No momento, as contas de avaliação não estão qualificadas para criar um perfil comercial do WhatsApp com a Twilio.

Etapa 1: Solicite acesso para ativar seus números Twilio para WhatsApp

Para habilitar seus números Twilio para WhatsApp, você precisará preencher o "Request Access" formulário da Twilio com informações precisas e atualizadas, incluindo sua ID do Facebook Business Manager. (Observação: ele não é o mesmo que sua página do Facebook). As informações devem corresponder à empresa cuja marca será representada no perfil comercial do WhatsApp. Fornecer informações incorretas aqui pode levar a atrasos no processo de integração.

Veja abaixo informações adicionais sobre alguns dos campos no formulário "Request Access" com base nas perguntas frequentes:

• Número de telefone: O número de telefone para em que o usuário ou a empresa que solicita acesso pode ser contatado, e não o número de telefone Twilio.
• Endereço de e-mail: O endereço onde a Twilio entrará em contato com as próximas etapas assim que sua conta for aprovada para uso da API do Twilio para WhatsApp em produção.
• Observação para ISVs: O e-mail enviado deve ir para quem estiver gerenciando o processo de integração. Para ISVs, ele deve ser o seu endereço de e-mail, não o do cliente.
• Você está trabalhando com um ISV, SI ou terceiros?: Identifique se você é um ISV/SI. Se você não for um ISV/SI, selecione No (Não).
  
  • Observação para ISVs: Se você estiver integrando um aplicativo para si mesmo, selecione Yes, I am an ISV or SI (Sim, sou um ISV ou SI). Se você estiver integrando um aplicativo para seu cliente, selecione Sim, esta solicitação é para um cliente que trabalha com um ISV ou SI no menu suspenso.
• Nome da empresa, website, país da sede: Informações da sua empresa. Para evitar atrasos, esse deve ser o mesmo nome de empresa usado em sua conta do Facebook Business Manager e o mesmo nome que será exibido no perfil comercial do WhatsApp, assim que você for ao ar.
• Observação para ISVs: Preencha esses campos com as informações da empresa do cliente.
• SID da conta Twilio: Seu SID principal da conta Twilio. Para encontrar o SID da sua conta, faça login no console, clique no botão “Home"(Iniciar) e localize o SID da sua conta no canto superior direito da página. Se essa for uma conta Flex, use seu SID do Projeto Flex.
• Observação para ISVs: Esse é o SID da subconta em que o WhatsApp Sender será provisionado. Deve haver uma subconta por cliente. Leia mais sobre subcontas aqui. Se essa for uma conta Flex, use seu SID do Projeto Flex.
  
  
• ID do Facebook Business Manager: Você pode encontrar este ID clicando neste link ou fazendo login em business.facebook.com > clicando em "Business Settings" > "Business Info" > Look for the Business Manager ID (Configurações de Negócios > Informações do Negócio > ID do Gerenciador de Negócios). (Mais informações sobre como enviar sua ID do Facebook Business Manager)
• "I've completed Facebook Business Verification": Saiba mais sobre a documentação do processo de verificação do Facebook.
• "I understand Twilio can modify my SMS/Voice URL and that approval is only for the brand submitted": A Twilio pode usar momentaneamente o SMS ou o URL de voz do seu número Twilio para registrar seu número no WhatsApp.

Aguardar pré-aprovação da Twilio

Depois de enviar o formulário "Request Access", você recebe um e-mail confirmando o envio do formulário.

Depois que a Twilio analisar sua conta, você recebe um e-mail com o assunto "You are now pre-approved to use Twilio APIs for WhatsApp". Esta mensagem contém as próximas etapas para enviar seu perfil de remetente e os modelos de mensagem do WhatsApp. Se faltarem informações de sua empresa ou se ela estiver em uma vertical proibida pela política comercial do WhatsApp, a Twilio pode rejeitar a sua submissão. A aprovação final é fornecida pelo WhatsApp depois que você enviar seu perfil de remetente (próxima etapa).

Etapa 2: Enviar um perfil de remetente e modelos de mensagem

Você receberá um e-mail de pré-aprovação contendo "next steps" para enviar um perfil de remetente e modelos de mensagem.

Posso usar meu próprio número?

Se você quiser usar seu número, ele pode ser usado se nunca tiver sido registrado com a API do WhatsApp Business com a Twilio. Você ainda precisa seguir as etapas descritas neste guia.

• Se você quiser transferir seu número para a Twilio, leia nosso artigo de suporte sobre como mover um número WhatsApp existente para a Twilio.
• Se você quiser apenas registrar seu próprio número sem fazer a transferência para a Twilio, leia nosso artigo de suporte sobre Ativar seu próprio número.

Submeter o Remetente do WhatsApp

Clique aqui ou navegue até a seção Messaging > Senders > WhatsApp Senders (Mensagens > Remetentes > Remetentes do WhatsApp) no console da Twilio. Clique no botão "Submit a WhatsApp Sender" (Enviar um remetente do WhatsApp) para criar um novo perfil de remetente. Se você já tiver um remetente do WhatsApp, o botão vai mostrar "New WhatsApp Sender".

A Twilio envia seu nome de exibição para o WhatsApp. Esta é a última informação que o WhatsApp precisa aprovar para registrar seu número. Você receberá uma confirmação automática por meio do Zendesk de que seu formulário de informações do perfil foi recebido.

Requisitos de logotipo

Os logotipos não são revisados pelo WhatsApp e podem ser definidos enviando um link para uma imagem como parte do seu perfil do WhatsApp Sender. Esteja ciente dos seguintes requisitos ao enviar um logotipo:

• Restrição de tamanho mínimo: 640 x 640 pixels
• Restrição de tamanho máximo: 5 MB
• Razão de proporção quadrada
• PNG ou JPG (JPG recomendado)
• Sem fundo transparente (alfa)

Você pode atualizar seu logotipo depois que seu perfil de remetente for aprovado, navegando até a página do WhatsApp Sender e clique no remetente.

Usar um nome de marca no seu perfil do WhatsApp Business

Você pode ter um nome de marca que deseja usar como o nome de exibição do seu perfil comercial do WhatsApp que difere do nome da sua empresa. Nesse caso, deve haver uma associação clara e publicada externamente entre sua empresa e a marca. Essa associação entre a marca e a sua empresa precisa ser exibida no seu site e no próprio nome de exibição.

Por exemplo, se a sua empresa for Johnny Mobile e a sua marca for "PizzaApp", recomendamos que utilize o nome de exibição "PizzaApp by Johnny Mobile.". Esta associação tem de ser publicada no seu website para que o WhatsApp possa verificá-la. Isso significa que, em algum lugar do site, deve haver uma relação visível entre os dois nomes. Se você quiser manter o nome "PizzaApp", isso geralmente exige um pedido ao WhatsApp e pode estender o processo de registro.

Para obter mais informações, consulte regras de nome de exibição do WhatsApp.

Etapa 3: Aprovar a Twilio para enviar mensagens em seu nome

Quando você receber um aviso de que a Twilio enviou seu nome de exibição e número para o WhatsApp, você precisa aprovar a Twilio para enviar mensagens em seu nome. Você recebe um e-mail para "Approve Twilio to message on behalf of" no Facebook Business Messenger. Esse e-mail geralmente tem o assunto "WhatsApp Profile Request."

Vá para o console do Facebook Business Manager (o que enviou no passo 1) e aprove a Twilio para "message on behalf of." Você pode encontrar este pedido clicando neste link ou acessando business.facebook.com na sessão Business Settings > Requests (Configurações de negócios > Solicitações). Uma vez lá, clique no botão Approve (Aprovar).

Etapa 4: Verifique sua conta do Facebook Business Manager

Observação: Se você já verificou sua conta do Facebook Business Manager anteriormente, não precisa concluir esta etapa novamente. Consulte a documentação do Facebook sobre como verificar sua empresa para obter mais informações.

Assim que você receber a capacidade de "Approve" da Twilio para enviar mensagens em seu nome, você pode verificar sua conta do Facebook Business Manager caso ainda não tenha feito isso. Em Facebook Business Manager > Settings console (Facebook Business Manager > Console de configurações), clique no botão Start (Iniciar) or Continue (Continuar) na sessão Verification (Verificação).

(O botão de verificação pode estar esmaecido antes de iniciar o processo de integração.)

Pode ser necessário fazer upload de documentos de apoio para verificar sua empresa. Consulte o guia do Facebook sobre como fazer upload de documentos oficiais para verificar sua empresa para obter mais informações.

O processo de verificação de negócios do Facebook pode levar de 5 a 20 dias úteis, dependendo da sua região e do tipo de empresa. Se você não tiver notícias do Facebook em mais de 10 dias úteis, informe a equipe da Twilio.

Etapa 5: A Twilio conclui seu registro do WhatsApp Sender

Depois de aprovar a Twilio para enviar mensagens em seu nome, a Twilio conclui o processo de registro para registrar seu remetente do WhatsApp. Você receberá um e-mail de confirmação de que o Twilio finalizou o registro do seu perfil.

Neste ponto, o remetente está pronto para receber mensagens de clientes em produção. Você pode fazer um teste enviando uma mensagem WhatsApp para o número Twilio e verificando a seção Logs de mensagens no console da Twilio. Depois de receber uma mensagem, você pode responder dentro de 24 horas com mensagens de formato livre. Você pode ler mais sobre mensagens de conversa com o WhatsApp aqui.

Etapa 6: Enviar modelos de mensagem

Para iniciar conversas com novos usuários ou com usuários existentes que não enviaram uma mensagem por mais de 24 horas, é necessário usar um modelo de mensagem. Para enviar um modelo de mensagem, vá para Messaging > Senders > WhatsApp Templates (Mensagens > Remetentes > Modelos do WhatsApp). Saiba mais sobre modelos de mensagens do WhatsApp aqui.

O que vem a seguir?

Depois de conectar o número Twilio e o perfil do WhatsApp Business, você terá muitas opções.

• Confira a Referência da API para ver exemplos de envio de mensagens com a API Twilio para WhatsApp
• Saiba como enviar e receber mensagens de mídia
• Complete uma API Twilio para WhatsApp na guia de Início rápido no idioma de sua escolha para começar rapidamente