Neste artigo, você aprenderá como criar uma conta Twilio necessária, como conectar um número comercial do WhatsApp à sua conta Twilio, que você usará para se comunicar com os clientes, e como conectar um número do WhatsApp ao Orderry.
​

O Twilio é uma plataforma de API de comunicação que permite que desenvolvedores e empresas integrem facilmente ferramentas de comunicação, como telefonia, SMS, conversas e vídeo, em seus aplicativos e sites. Com o Twilio, é possível enviar mensagens de texto, fazer chamadas telefônicas, configurar respostas automatizadas e muito mais. O Twilio nos ajudará a integrar o WhatsApp ao Orderry.
​

Antes de começar a usar este guia, você precisará de:

Se você estiver usando seu próprio número de telefone, ele deverá ser capaz de receber SMS ou chamadas telefônicas. Se o número só puder receber chamadas telefônicas, ele não poderá estar usando uma RIV (resposta interativa de voz).

Depois de ter a versão paga do Twilio, você precisa registrar um WhatsApp sender, que permitirá enviar e receber mensagens do WhatsApp da marca da sua empresa usando as APIs do Twilio. Algumas restrições são impostas pela Meta (a empresa proprietária do WhatsApp) e você provavelmente precisará concluir a verificação comercial da Meta antes de colocar seu aplicativo em produção ou integrar outros WhatsApp senders.
​

Para criar um WhatsApp sender:
​

1. Comece fazendo login no console do Twilio.
​

2. Navegue até Messaging > Senders > WhatsApp senders. Isso o levará à seção WhatsApp Senders do console, onde você criará seu WhatsApp sender.
​

3. Revise as informações nesta página e clique em Get Started.
​

4. Veja os Termos de Serviço do WhatsApp e marque a caixa se você concordar com eles. Em seguida, clique em Confirm.
​

5. Em seguida, selecione o número de telefone que deseja conectar à API comercial do WhatsApp. Você pode usar seu número Twilio ou seu próprio número de telefone. Clique em Continue.
​

Esta etapa abrirá uma janela pop-up que leva ao Facebook.com. Não feche a janela pop-up nem navegue para uma página diferente no console do Twilio. Você precisará da janela do Console do Twilio para as etapas posteriores deste guia.
​

1. Faça login no Facebook, se ainda não o fez, ou clique em Continue as [seu nome] se já estiver conectado. Depois de fazer login, você verá uma visão geral do processo para conectar seu número ao WhatsApp.
​

2. Depois de fazer login, você verá as próximas etapas do processo de conexão do seu número ao WhatsApp. Clique em Get started.
​

3. O Facebook solicitará que você permita que o Twilio gerencie sua conta comercial do WhatsApp. Clique em Continue para prosseguir.
​

4. Na próxima tela, selecione na lista a Meta Business Account da sua empresa. Se você não tiver uma, poderá criar uma nova selecionando a opção Create a Business Account.
​

5. Em seguida, você poderá selecionar uma WhatsApp Business Account (WABA) ou criar uma nova.
​

Ao registrar o primeiro WhatsApp sender em uma conta Twilio, crie uma nova WABA para ser usada apenas com essa conta Twilio específica. Ao integrar remetentes adicionais na mesma conta Twilio, você precisará selecionar o mesmo WABA que criou durante o processo de integração do primeiro WhatsApp Sender. Quando um WABA estiver conectado à sua conta Twilio, o ID será mostrado na página WhatsApp sender.
​

Importante: se você já tiver um número do WhatsApp aprovado com outro provedor, siga as etapas deste artigo.
​

6. Na próxima tela, você precisará inserir as seguintes informações:
​

WhatsApp Business Account Name - Isso é usado apenas para fins internos e não é voltado para o consumidor. Se você selecionou uma WABA na tela anterior, não poderá alterar o nome aqui.
​

WhatsApp Business Profile Display Name - É o que seus clientes verão. Ele deve atender aos requisitos definidos pelo WhatsApp.
​

Category - Selecione a categoria que melhor descreve sua empresa. Ela é mostrada aos consumidores quando eles visualizam seu perfil.
​

Business Description - Também é exibida aos consumidores quando eles visualizam seu perfil no aplicativo WhatsApp.
​

Website - Também é mostrado aos consumidores quando eles visualizam seu perfil no aplicativo WhatsApp. Depois de registrar seu WhatsApp sender, você poderá adicionar outro site, se desejar.
​

É altamente recomendável usar o nome da sua empresa como nome de exibição ao registrar os WhatsApp sender, pois o WhatsApp rejeitará qualquer coisa que não corresponda ao nome da empresa no Business Manager vinculado.
​

No entanto, você pode ter um nome de marca que deseja usar como nome de exibição para seu perfil comercial do WhatsApp que seja diferente do nome de 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 sua empresa precisa ser exibida em seu site e no próprio Nome de exibição.
​

Por exemplo, se sua empresa for a Johnny Mobile e sua marca for “PizzaApp”, recomendamos o uso do Nome de Exibição “PizzaApp by Johnny Mobile”. Essa associação deve ser publicada em seu site, 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 quiser manter o nome “PizzaApp”, isso geralmente exigirá um recurso ao WhatsApp e poderá estender o processo de registro.
​

Para obter mais informações, você pode consultar as regras de nome de exibição do WhatsApp.
​

1. Se estiver usando um número Twilio com recursos de SMS, mude para a janela do Console Twilio que você deixou aberta na etapa 1 e clique para copiar seu número Twilio.
​

2. Em seguida, cole o número na janela pop-up do Facebook. Mantenha o método de verificação por mensagem de texto selecionado e clique em Send Code.
​

Se não estiver usando um número Twilio, digite o número que deseja usar e escolha o método de verificação.
​

Não continue se receber uma mensagem de aviso sobre a transferência do seu número. Em vez disso, abra um tíquete de suporte e informe que precisa que seu número seja migrado da Meta ou da empresa anterior (ou seja, do Business Solution Provider) com a qual você trabalhou.
​

3. O código de verificação será exibido no console do Twilio sob o título Verification code. Clique em Copy e cole-o na janela pop-up do Facebook.
​

4. Em seguida, clique em OK na tela seguinte para fechar a janela pop-up.
​

Parabéns! Sua conta do WhatsApp Business agora está vinculada à sua conta do Twilio. O Twilio iniciará o processo de registro do seu número no WhatsApp. Esse processo pode levar até 2 minutos.
​

Após o registro bem-sucedido, seu número será exibido. Você pode clicar em Edit Sender para usar um serviço de mensagens, definir seus webhooks de mensagens recebidas e atualizar o restante do seu perfil do WhatsApp Business, incluindo sua foto de perfil.
​

Se você ainda não tiver concluído a verificação de negócios Meta, seu acesso ao WhatsApp será limitado no início. Se já tiver concluído a verificação de negócios, você terá acesso total ao WhatsApp.
​

Para integrar números adicionais, você precisa repetir esse processo, tendo o cuidado de selecionar a mesma conta do Meta Business Manager e a mesma conta do WhatsApp Business. O Meta Business Manager e a conta do WhatsApp Business atualmente vinculados à sua conta Twilio são exibidos no Console Twilio.
​

Observação: até que você conclua a verificação do Meta Business, alguns números podem permanecer em um status pendente e não podem ser usados para enviar mensagens. Depois de concluir a verificação do Meta business, talvez seja necessário excluir os WhatsApp sender e passar pelo processo novamente para integrá-los completamente.
​

Para criar um serviço de mensagens, vá para Messaging > Services e clique em Create Messaging Service.
​

Etapa 1. Preencha os campos a seguir:
​

Messaging Service friendly name - crie um nome para o seu serviço de mensagens (por exemplo, conversas sobre ordens)
​

Select what you want to use Messaging for - escolha o objetivo que melhor se adapte às suas conversas.
​

Clique em Create Messaging Service.
​

Etapa 2. Clique em Add senders, selecione WhatsApp Number e escolha o número para o qual deseja ativar o Messenger Service. Você pode personalizar ainda mais o número selecionado.
​

Sticky Sender - Garante a consistência para os destinatários da mensagem, selecionando o mesmo número de telefone que você usou anteriormente na conversa com um determinado cliente.
​

Area Code Geomatch - Use números de telefone locais com códigos de área que correspondam ou sobreponham o número de telefone do destinatário ao enviar mensagens para os EUA e o Canadá.
​

Esses recursos são ativados por padrão. Para desativá-los, clique no botão de alternância.
​

Você também pode adicionar mais números, caso não tenha selecionado vários números na etapa anterior, clicando no botão Add Senders ou excluir um número já adicionado clicando em Remove ao lado dele.
​

Selecione os números que deseja configurar e clique em Step 3. Set up integration.
​

Etapa 3. Nesta etapa, você precisa configurar webhooks para automatizar processos e sincronizar dados entre suas contas Twilio e Orderry.
​

Selecione a opção Use webhooks e cole os links necessários nos campos a seguir:

https://app.orderry.com/chat-service/v1/webhook/twilio/whatsapp

https://app.orderry.com/chat-service/v1/webhook/twilio/whatsapp/status
​

A opção HTTP Post deve ser ativada ao lado dos campos Request URL e Fallback URL.
​

Recomendamos deixar o valor padrão de 14400 no campo Validity period. O período de validade refere-se ao número de segundos durante os quais as mensagens enviadas de seu serviço de mensagens permanecerão na plataforma do Twilio. Se o tempo necessário para enviar a mensagem exceder o Período de validade, o Twilio falhará na mensagem e enviará uma solicitação à URL de retorno de chamada de status para notificar seu aplicativo sobre a falha.
​

Para continuar, clique em Step 4: Add compliance info.
​

Etapa 4. Adicione informações de conformidade. Isso pode ser feito registrando-se para o A2P 10DLC (código de 10 dígitos) nos Estados Unidos.
​

Esse é um sistema nos Estados Unidos que permite que as empresas enviem mensagens de aplicativo para pessoa (A2P) usando números de telefone de 10 dígitos (10DLC). O registro para mensagens A2P melhorará a qualidade da entrega e reduzirá a filtragem.

Para concluir a criação do serviço de mensagens, clique em Complete Messaging Service Setup.
​

Uma etapa importante na configuração da sua conta Twilio é configurar a autenticação básica HTTP na sua conta Twilio para que o recebimento de mídia funcione corretamente.
​

Para fazer isso, vá para Messaging > Settings > General > HTTP Basic Authentication for media access, selecione a opção Disabled e clique em Save na parte inferior da página para salvar as alterações.
​

Pronto! A última etapa é conectar-se ao Orderry e, depois disso, você poderá usar o WhatsApp para se comunicar com seus clientes.
​

1. No painel do Twilio, vá para a seção Account Info. Aqui você encontrará o Account SID e o Auth Token de que precisa para se conectar às conversas do Orderry. Copie essas informações.
​

2. Em seguida, vá para Messaging > Services e encontre o Messaging Service que você criou. Copie seu Sid.
​

3. No Orderry, vá para Configurações > Conversas e clique em + Canal. Selecione o recurso WhatsApp by Twilio.
​

4. Preencha todos os campos:
​

Nome do canal - crie um nome para o canal do WhatsApp que você usará para se comunicar com os clientes.
​

Account SID - cole o código Account SID copiado de sua conta Twilio.
​

Importante: se um canal com um SID de conta idêntico já estiver conectado por outra empresa, o sistema não permitirá que você conecte um novo canal com o SID de conta no Orderry. Para corrigir isso, você precisa excluir a integração existente em outra empresa e, em seguida, adicionar um canal com esse SID de conta ao Orderry.
​

Token de autenticação - cole o código do Token de autenticação copiado de sua conta Twilio aqui.
​

Phone number - digite o número de telefone que você registrou no Twilio e que usará para se comunicar com os clientes.

Sid do serviço de mensagens - aqui você precisa colar o código Sid do serviço de mensagens copiado da página do serviço de mensagens.
​

5. Configure o acesso ao canal:
​

Todos - todos os funcionários da empresa terão acesso às Configurações de conversa, desde que esse acesso seja permitido pelo sistema;
​

Selecionados - somente os funcionários selecionados terão acesso às Configurações de conversa, desde que sejam autorizados pelo sistema;
​

Proprietário - somente o proprietário da empresa terá acesso às configurações.
​

Para alterar as configurações de acesso dos funcionários às configurações de Conversa e Chat, vá para Configurações > Funcionários > Funções e edite as configurações necessárias.
​

6. Clique em Criar.
​

Pronto! Agora você pode conversar com os clientes usando o WhatsApp diretamente no Orderry. Mais informações sobre como usar os modelos do WhatsApp no Orderry podem ser encontradas aqui.
​

O preço do WhatsApp é calculado com base na taxa de preço baseada em conversas da Meta e na taxa por mensagem da Twilio.
​

As primeiras 1.000 conversas por mês são gratuitas, desde que ocorram nas primeiras 24 horas após o recebimento de uma mensagem de um usuário. Todas as conversas iniciadas após esse período são cobradas.
​

Por exemplo, US$ 0,015 para cada conversa e US$ 0,005 para cada mensagem de um número dos EUA.
​

Assim, o custo total do uso do WhatsApp inclui a taxa por conversa da Meta e a taxa por mensagem da Twilio. Para obter mais informações sobre os preços do WhatsApp da Twilio, clique aqui.