You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Classifique esta página:

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

O suporte da Twilio para a API do WhatsApp Business agora está disponível no mercado! Leia mais no Registro de alterações.

A partir de 21 de setembro de 2020, Twilio e WhatsApp implementaram um novo processo para a integração de ISV, SI e ISV/SI do cliente final. Este novo processo é descrito abaixo.

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.

Certifique-se de que sua empresa não esteja na lista de verticais proibidas na política de comércio do WhatsApp. Além disso, os desenvolvedores precisam verificar seus negócios com o Facebook Business Manager como parte do processo de integração do WhatsApp.

Note: Once a number is registered with WhatsApp on Twilio's API or with any other Business Solution Provider, that number can no longer be used in the WhatsApp consumer or business app. WhatsApp may allow numbers to be deleted from the API after a 3 month period of inactivity.

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.

Observe que para fornecedores terceiros: Se você for um fornecedor de terceiros, fornecedor independente de software (ISV) ou integrador de sistemas (SI), também precisará de:

  • Subconta da Twilio para seu cliente: É aqui que a conta do cliente será provisionada. É a subconta na conta (dos ISVs). Você deve enviar este SID de conta no formulário "Request Access", tanto no campo do Sid principal quanto no campo "Assign approval to alternate Account SID".

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

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.

Observação: A partir de 21 de setembro de 2020, Twilio e WhatsApp implementaram um novo processo para a integração de ISV, SI e ISV/SI do cliente final.

Ao preencher o formulário "Request Access", anote as informações abaixo (identificadas como Observação para ISVs) para garantir que você represente corretamente seu cliente.

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

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.

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".

WhatsApp Senders

Ao submeter um perfil comercial, o "Display Name" deve ser o nome comercial usado na conta do Facebook Business Manager. Se você quiser usar outro nome, ele deve seguir as regras de nome de exibiçãodo WhatsApp.

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).

approve-twilio-request-800.jpg

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).

facebook_business_verification_button.jpg

(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.

        
        
        
        Envie uma mensagem de formato livre dentro de uma sessão de 24 horas

        Enviar uma mensagem de saída em formato livre com o WhatsApp

        Envie uma mensagem de formato livre dentro de uma sessão de 24 horas

        O que vem a seguir?

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

        Classifique esta página:

        Precisa de ajuda?

        Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

              
              
              

              Obrigado pelo seu feedback!

              Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

              Enviando seu feedback...
              🎉 Obrigado pelo seu feedback!
              Algo deu errado. Tente novamente.

              Obrigado pelo seu feedback!

              Indique‑nos e obtenha USD10 em 3 etapas simples!

              Etapa 1

              Obtenha o link

              Obtenha um link de indicação pessoal gratuito aqui

              Etapa 2

              Dê USD10

              Seu usuário se inscreve e faz a atualização usando o link

              Etapa 3

              Obtenha USD10

              1.250 mensagens SMS grátis
              OU 1.000 min de voz grátis
              OU 12.000 chats
              OU mais