Neste artigo, você aprenderá como criar a conta Twilio necessária, configurar e conectar o recurso SMS by Twilio ao Orderry.
O que é o Twilio?
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, você pode enviar mensagens de texto, fazer chamadas telefônicas, configurar respostas automatizadas e muito mais. O Twilio nos ajudará a integrar o SMS ao Orderry.
Criar uma conta Twilio
Antes de começar a usar este guia, você precisará de:
Uma conta Twilio atualizada. Se você for novo no Twilio, crie uma conta gratuita e atualize-a vinculando um método de pagamento. Para obter mais informações sobre como atualizar para um plano pago, consulte Atualização para uma conta paga do Twilio no artigo Como atualizar sua conta e comprar números no Twilio
Número de telefone do Twilio. Você pode saber como comprar um número de telefone Twilio no artigo Como atualizar sua conta e comprar números no Twilio na seção Como comprar um número Twilio?
A próxima etapa é criar um serviço de mensagens.
Criar um serviço de mensagens
Para criar um serviço de mensagens, vá para Messaging > Services e clique em Create Messaging Service.
Etapa 1. Especifique o nome e a finalidade do serviço
Messaging Service friendly name - crie um nome para o seu serviço de mensagens (por exemplo, conversas sobre ordens)
Observação: esse nome só será exibido no Twilio. Quando seus clientes receberem uma mensagem, eles verão apenas o número de telefone do remetente.
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. Adicionar o número
Clique em Add senders, selecione Phone number e escolha o número para o qual você 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 De 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. Configurações de webhooks
Nesta etapa, você precisa configurar webhooks para automatizar processos e sincronizar dados entre suas contas Twilio e Orderry.
Selecione a opção Send a webhook e cole os links necessários nos campos a seguir:
Nos campos Request URL e Fallback URL - o mesmo link:
No campo Callback URL:
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. Adicionar informações de conformidade
Importante: esta etapa só é necessária se você estiver usando um número dos EUA.
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 A2P 10DLC por meio do Twilio envolve várias etapas:
configuração de sua conta;
registro da sua marca;
registro dos seus casos de uso;
registro de seus números de telefone.
O preenchimento do formulário leva alguns minutos se você tiver preparado todas as informações necessárias. A aprovação final do seu registro leva de uma a duas semanas. Você pode usar o Console Twilio para verificar o status do seu registro US A2P 10DLC.
Você pode finalizar a criação e a configuração do Serviço de Mensagens antes que seu registro A2P 10DLC seja aprovado. Isso permitirá que você tenha seu sistema pronto para operação total assim que o registro for concluído. Use esse tempo para testar e configurar todos os componentes necessários para garantir que seu serviço esteja funcionando sem problemas.
Observe que, até que o registro seja concluído, pode haver restrições quanto ao número e à frequência das mensagens que podem ser enviadas, e o envio de grandes volumes de mensagens antes da conclusão do registro pode resultar no bloqueio ou na redução da prioridade das mensagens.
Você pode saber mais sobre o processo de registro do A2P 10DLC aqui.
Portanto, para concluir a criação do serviço de mensagens, clique em Complete Messaging Service Setup.
Pronto! A última etapa é conectar-se ao Orderry e, depois disso, você poderá usar o SMS para se comunicar com seus clientes.
Conectar-se ao Orderry
Para conectar um número de SMS por Twilio ao Orderry:
1. No painel do Twilio, vá para a seção Account Info. Aqui você encontrará o Account SID e o Auth Token necessários 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 SMS por Twilio.
4. Preencha todos os campos:
Nome do canal - crie um nome para o canal de SMS 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 aqui o código do Auth Token copiado de sua conta Twilio.
Número de telefone - digite o número de telefone que você registrou no Twilio e que usará para se comunicar com os clientes.
Observação: você pode conectar apenas um canal por número. Ou seja, se você já tiver um canal do WhatsApp conectado ao mesmo número, não poderá criar um canal de SMS.
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 SMS diretamente no Orderry. Saiba mais sobre como as conversas funcionam aqui.