Como conectei a API de negócios oficial do WhatsApp via Twilio

Como você sabe, o WhatsApp começou recentemente a fornecer acesso à sua API oficial de negócios, tão necessária para a criação de bots de bate-papo para este mensageiro usando métodos "brancos".



Mas a maioria das empresas ainda não pode fazer isso diretamente, mas apenas por meio de grandes parceiros do Facebook, que neste caso atuam como intermediários.



Um desses parceiros disponíveis é a empresa americana Twilio. Sua principal vantagem, na minha opinião, é o baixo custo de utilização da API WhatsApp Business.



Conectei a API de negócios oficial do WhatsApp por meio do Twilio e agora contarei a vocês em detalhes como fazer isso.



Whatsapp Messenger



A principal condição para o Facebook é a presença de uma pessoa jurídica registrada, por exemplo, LLC ou empresário individual, o acesso a um indivíduo não funcionará.



Portanto, vamos começar a mover-se por etapas.



1. Criação de uma conta no Facebook Business Manager



Faça login na sua conta pessoal do Facebook e crie uma conta de Business Manager, para a qual seguimos o link business.facebook.com/overview e pressione o botão CRIAR CONTA, uma janela para inserir os dados da empresa se abrirá.



Criação de uma conta de gerente de negócios no Facebook



De acordo com os prompts acima dos campos, digite o nome da empresa, nome e sobrenome, e-mail e clique no botão "Enviar".



Na janela seguinte, insira informações sobre a empresa e pressione o botão "Enviar".



        Facebook Business Manager



Após o envio, aparecerá uma mensagem informando que a conta foi criada e você precisa confirmar seu endereço de e-mail.



         Facebook Business Manager



Vamos ao correio e clicar no botão "Confirmar" da carta.



        Facebook Business Manager



2. Registrando uma conta no Twilio



Vamos registrar uma conta Twilio em twilio.com/try-twilio . Não é nada difícil fazer isso, o registro é gratuito e não requer dados de cartão bancário, você só precisa digitar seu nome, sobrenome, e-mail e uma senha.



   Twilio



Confirmamos o e-mail.



 e-mail     Twilio.



Confirmamos o número de telefone.



      Twilio



3. Solicite ao Twilio para ativar a capacidade de adicionar remetentes do WhatsApp



Vamos preparar e enviar uma solicitação ao Twilio para ativar a capacidade de adicionar remetentes do WhatsApp, para a qual vamos para a seção "Remetentes do WhatsApp" no link www.twilio.com/console/sms/whatsapp/senders e clique no botão "Inscreva-se para receber atualizações".



       WhatsApp   Twilio



Um formulário de solicitação será aberto para ativar a capacidade de adicionar remetentes do WhatsApp ao Twilio. Ao criar uma conta no Facebook Business Manager, preenchemos os campos do formulário com os dados indicados acima:



Primeiro Nome - Nome (em Latim);



Sobrenome - Sobrenome (latino);



Número de telefone - número de telefone da empresa (especificado no Facebook Business Manager);



Endereço de e-mail - endereço de e-mail da empresa (especificado no Facebook Business Manager);



Nome da empresa- Nome da empresa (em latim, indicado no Facebook Business Manager);



Site da empresa - Site da empresa (listado no Facebook Business Manager);



País da sede da empresa - País de constituição da empresa (especificado no Facebook Business Manager);



Twilio Account SID - Copie o Twilio Account ID do campo ACCOUNT SID em www.twilio.com/console;



Twilio Account SID



ID do Facebook Business Manager - Copie o identificador da conta criada do Facebook Business Manager do campo " Business Manager ID :" na página business.facebook.com/settings/info (Facebook Business Manager -> Configurações da empresa -> Informações da empresa);



Facebook Business Manager ID



Concluí a Verificação de negócios do Facebook- coloque “Não” se Facebook Business Manager -> Configurações da empresa -> Informações da empresa -> Status de confirmação da empresa -> “Não confirmado” ou “Sim” se “Confirmado” for indicado;



Vertical da empresa - escolha a direção da empresa na lista;



Qual é o seu caso de uso? - escolha na lista o que o WhatsApp será usado para: Notificações, Suporte ao Cliente, 2FA ou Verificação de Usuário (autenticação de dois fatores ou verificação de usuário);



Para quais regiões você está enviando mensagens? - Em quais regiões as mensagens serão enviadas (selecione na lista Global) ;



Quantas mensagens você está enviando por mês durante o primeiro ano?- Quantas mensagens serão enviadas por mês durante o primeiro ano (selecione o intervalo desejado na lista);



Desejo provisionar esta conta com um fornecedor terceirizado - Se esta conta será fornecida a um fornecedor terceirizado (selecione "Não") ;



Atribuir aprovação para SID de conta alternativo (opcional) - Atribuir aprovação a um SID alternativo da conta (opcional) (não insira nada, deixe o campo em branco) ;



Eu entendo que Twilio pode modificar meu SMS / URL de voz e que a aprovação é apenas para a marca enviada. - Eu entendo que Twilio pode alterar meu URL de SMS / correio de voz e esta aprovação é apenas para a marca enviada (concorde e selecione "Sim")...



        WhatsApp   Twilio



Para enviar uma solicitação, clique no botão "Solicitar Agora". Após o envio bem-sucedido, uma notificação correspondente aparecerá: “Obrigado pelo seu interesse. Vamos mantê-lo atualizado conforme o acesso se tornar disponível. "



         WhatsApp   Twilio



Recebemos a seguinte carta pelo correio:



  Twilio        WhatsApp   Twilio



Traduzimos a mensagem para o russo:



     Twilio        WhatsApp   Twilio.



Agora estamos aguardando 3-4 semanas por uma resposta de Twilio, conforme indicado na carta.



Após 4 semanas, recebemos uma resposta do Twilio que agora você pode adicionar um remetente do WhatsApp e continuar o processo de registro: Nós



  Twilio       WhatsApp   Twilio



traduzimos a mensagem para o russo:



     Twilio       WhatsApp   Twilio



4. Atualize sua conta Twilio



Para continuar, você deve definitivamente transferir o projeto Twilio do teste para o upgrade, para o qual você precisará repor o seu saldo. A conta de teste do Twilio não será capaz de registrar o WhatsApp do remetente. O valor mínimo para recarga é de $ 20 (vinte dólares). Então, esse dinheiro pode ser gasto no aluguel de números de telefone para remetentes do WhatsApp e no pagamento de mensagens recebidas e enviadas no WhatsApp. O aluguel de um número de telefone começa em $ 1 (um dólar) por mês. Mensagens recebidas e enviadas no WhatsApp - 0,005 $ (meio centavo) por 1 mensagem.



Para atualizar sua conta, acesse o link www.twilio.com/console/billing/upgrade .



Preencha os campos na seção "Adicionar endereço da empresa" com letras latinas.



  Twilio:



Pressione o botão "Validar Endereço" para confirmar o endereço. Na janela que se abre, clique no botão "Usar este endereço".



  Twilio:



Da mesma forma, preencha os campos na seção "Adicionar endereço de cobrança" com os mesmos dados.



  Twilio:



E também confirmaremos o endereço.



  Twilio:



Na seção "Adicionar informações de pagamento e fundos", insira os detalhes do cartão do banco e pressione o botão "Atualizar conta" para concluir o pagamento.



  Twilio:



Após o pagamento com sucesso, veremos uma notificação correspondente.



     Twilio



5. Comprar um número de telefone no Twilio para criar um remetente do WhatsApp



Infelizmente, não há números russos no Twilio, mas na prática acabou não sendo tão importante. Freqüentemente, os usuários nem olham para o número quando escrevem no WhatsApp.



Para comprar um número de telefone Twilio , siga o link www.twilio.com/console/phone-numbers/search , selecione um país no campo “PAÍS”, se desejar, você pode definir outros parâmetros de pesquisa adicionais e pressione o botão “Pesquisar”.



    Twilio



    Twilio



Selecione o número de telefone desejado e pressione o botão "Comprar".



Na próxima janela, iremos confirmar a compra.



    Twilio



6. Registrando WhatsApp Sender com Twilio



Para registrar um remetente do WhatsApp no ​​Twilio, vá para a seção “Remetentes do WhatsApp” em www.twilio.com/console/sms/whatsapp/senders e clique no ícone de adição.



  WhatsApp  Twilio



Por enquanto, vamos criar um remetente de WhatsApp apenas para respostas às mensagens dos usuários, ou seja, não vamos escrever primeiro. A criação de modelos para a capacidade de escrever primeiro para o usuário será considerada nas publicações a seguir.



Preencha o formulário que se



abre : Selecione um número (obrigatório) - Selecione o número de telefone que compramos no Twilio acima.



Nome de exibição da empresa (obrigatório) - O nome de exibição que deve estar relacionado à sua empresa conforme exigido pelo Facebook... Você pode simplesmente especificar o nome da empresa que inserimos ao registrar uma conta no Facebook Business Manager.



Endereço da empresa (opcional) - Endereço da empresa (opcional ).



Email da empresa (opcional) - Endereço de email da empresa (opcional ).



Site (opcional) - Site da empresa (opcional ).



Link para o logotipo (opcional) - Link para o logotipo da empresa (você pode omiti-lo). O tamanho mínimo da imagem é 640x640 px nos formatos PNG ou JPG (recomenda-se JPG), o fundo não deve ser transparente.



Verifique se o perfil é para um cliente. Eu li as diretrizes de terceiros - não marque esta caixa.



  WhatsApp   Twilio



Para enviar, clique no botão “Enviar Solicitação”, que ficará ativo após o preenchimento dos campos obrigatórios do formulário.



Uma entrada com o status "Aguardando Aprovação do WhatsApp" aparecerá na lista de remetentes, o que significa que agora você precisa aguardar a confirmação do WhatsApp.



 WhatsApp  Waiting for Approval from WhatsApp  Twilio



E recebemos um e-mail do Twilio informando que eles estão considerando nossa solicitação e entrarão em contato conosco em breve.



  Twilio     WhatsApp



Estou ansioso para ouvir de Twilio.



7. Confirmação da empresa no Facebook Business Manager



Cerca de uma hora e meia depois, recebemos outro e-mail do Twilio informando que o Facebook Business Manager precisa aceitar uma solicitação do Twilio para conceder-lhes permissão para criar uma conta WhatsApp Business. Para fazer isso, siga o link business.facebook.com/settings/requests/received_requests (Facebook Business Manager -> Configurações da empresa -> Solicitações -> Recebido) e clique no botão "Aprovar".



   Twilio  Facebook Business Manager



Depois de aceitar a solicitação do Twilio, você precisa confirmar a empresa no Facebook Business Manager. Para fazer isso, siga o link business.facebook.com/settings/security (Facebook Business Manager -> Configurações da empresa -> Central de segurança) e na seção “Confirmação da empresa” clique no botão “Iniciar confirmação”, que ficará ativo após aceitar a solicitação do Twilio.



    Facebook Business Manager



As informações oficiais do Facebook sobre a confirmação da empresa podem ser encontradas no link: www.facebook.com/business/help/2058515294227817?id=180505742745347 .



No primeiro passo de confirmação, iremos inserir os dados da nossa empresa:



Razão Social da empresa - o nome da empresa, conforme indicado nos documentos de registo da empresa.



País - o país onde a empresa está registrada.



Endereço (logradouro, nº da residência) - logradouro e nº da residência do endereço legal da empresa, conforme indicado nos documentos de registo da empresa.



Endereço 2 / Liquidação - insira, se disponível.



Cidade - é a cidade do endereço legal da empresa, conforme indicado nos documentos de registro da empresa.



Estado / Província / Região- a região do endereço legal da empresa, conforme indicado nos documentos de registro da empresa.



Código Postal - O código postal da sede da empresa conforme indicado nos documentos de registo da empresa.



Número de telefone da empresa - o número de telefone pertencente a esta pessoa jurídica (deve haver documentos comprovativos: contrato, faturas de pagamento do telefone, etc.).



Site - o endereço do site da empresa (o domínio do site deve corresponder ao domínio do endereço de e-mail da empresa).



   Facebook Business Manager.  1 -   .



A segunda etapa para confirmar a empresa é confirmar a razão social da empresa.



Para fazer isso, você precisa baixar os documentos da lista:



  • Licença comercial (se houver);
  • Certificados de registro ou contrato social (OGRN ou contrato social);
  • Certificado de Registro de Contribuinte (TIN).


Fiz upload de scans de OGRN e TIN da empresa.



   Facebook Business Manager.  2 -    .



Na terceira etapa de confirmação da empresa, você deve confirmar o endereço legal e o número de telefone da empresa.



Para fazer isso, você precisa baixar os documentos da lista:



  • Contas de serviços públicos, como luz ou telefone;
  • Certificado do banco, que contém o endereço;
  • Licença comercial com endereço da empresa ou número de telefone (se aplicável).


Fiz upload de scans de: um contrato de aluguel de escritório em um endereço legal, uma carta informativa sobre o registro no Registro Estatístico de Rosstat, uma fatura de pagamento por um número de telefone de uma operadora de telecomunicações.



   Facebook Business Manager.  3 -       .



Na quarta etapa, você precisa obter e inserir um código de confirmação.



Para fazer isso, selecione um número de telefone na seção "Escolha como entrar em contato com você" e clique no botão "Ligue para mim". Deixe o campo "Meu endereço de e-mail comercial" em branco. O robô irá ligar e ditar os números a serem inseridos no campo de entrada do código de confirmação.



Digite os números do código de confirmação e pressione o botão "Enviar".



Estamos aguardando a confirmação do Facebook, pois eles nos escrevem na carta do Twilio. Isso pode levar de 4 a 7 dias úteis.



Recebemos a confirmação da empresa do Facebook em 1 dia útil.



  Facebook  ,    .



  Facebook Business Manager,    .



      Facebook Business Manager,   .



Uma marca de verificação verde nas Informações da empresa no Facebook Business Manager que indica que a empresa foi verificada.



Estamos aguardando a conclusão do cadastro do remetente do WhatsApp do Twilio.



8. Conclua o registro do remetente do WhatsApp no ​​Twilio



Após 4 horas, recebemos um e-mail de Twilio informando que eles verificaram nosso perfil de negócios no WhatsApp e enviaram nosso nome de exibição para análise. O cronograma de verificação do nome de exibição é normalmente de 24 a 48 horas.



Um e-mail do Twilio informando que eles verificaram nosso perfil de negócios no WhatsApp.



Traduzimos a mensagem para o russo:



Tradução de cartas do Twilio em russo que verificaram nosso perfil de negócios no WhatsApp.



Estamos aguardando uma resposta de Twilio 24-48 horas, conforme indicado na carta.



Após cerca de 30 horas, recebemos um e-mail do Twilio informando que nosso perfil de remetente do WhatsApp com o número de telefone selecionado foi registrado com sucesso. Traduzimos



Um e-mail do Twilio informando que o perfil do remetente do WhatsApp com o número de telefone selecionado foi registrado com sucesso.



a mensagem para o russo:



Tradução para o russo de uma carta do Twilio informando que o perfil do remetente do WhatsApp com o número de telefone selecionado foi registrado com sucesso.



Faça login em sua conta do Twilio, vá para a seção de remetentes do WhatsApp em www.twilio.com/console/sms/whatsapp/senders e veja se o registro mudou de status para “Aprovado”.



O remetente do WhatsApp foi aprovado pelo Twilio e está pronto para usar.



Resultado



Isso conclui a conexão da API de negócios oficial do WhatsApp por meio do Twilio. Com o tempo, com todas as expectativas, demorei cerca de um mês. Agora ele pode ser usado para integração com vários serviços de comunicação com os usuários e para a criação de bots de bate-papo.



All Articles