Neste artigo, aprenderá a criar a conta Twilio necessária, a configurar e a ligar a funcionalidade SMS by Twilio ao RemOnline.
O que é o Twilio?
Twilio é uma plataforma API de comunicação que permite aos programadores e às empresas integrar facilmente ferramentas de comunicação como telefonia, SMS, conversas e vídeo nas suas aplicações e sites. Com o Twilio, é possível enviar mensagens de texto, fazer chamadas telefônicas, configurar respostas automáticas e muito mais. O Twilio ajudar-nos-á a integrar o SMS no RemOnline.
Criar uma conta Twilio
Antes de começar a utilizar este guia, precisará de:
Uma conta Twilio atualizada. Se for novo no Twilio, crie uma conta gratuita e atualize-a associando um método de pagamento. Para obter mais informações sobre como atualizar para um plano pago, consulte Atualizar para uma conta Twilio paga no artigo Como atualizar a sua conta e comprar números no Twilio
Número de telefone Twilio. Pode saber como comprar um número de telefone Twilio no artigo Como atualizar a sua conta e comprar números no Twilio na secção Como comprar um número Twilio?
O próximo passo é criar um serviço de mensagens.
Criar um serviço de mensagens
Para criar um serviço de mensagens, aceda a Messaging > Serviços e clique em Create Messaging Service.
Passo 1. Especifique o nome e o objetivo do serviço
Messaging Service friendly name - crie um nome para o seu serviço de mensagens (por exemplo, conversas sobre ordens)
Atenção: este nome só será apresentado no Twilio. Quando os seus clientes receberem uma mensagem, apenas verão o número de telefone do remetente.
Select what you want to use Messaging for - escolha o objetivo que melhor se adequa às suas conversas.
Clique em Create Messaging Service.
Passo 2. Adicionar o número
Clique em Add senders, selecione Phone number e escolha o número para o qual ativa o Serviço de Mensageiro. Pode personalizar ainda mais o número selecionado.
Sticky Sender - assegura a consistência para os destinatários das mensagens, selecionando o mesmo número de telefone De que utilizou anteriormente na conversa com um determinado cliente.
Area code Geomatch - Utiliza números de telefone locais com códigos de área que correspondem ou se sobrepõem ao número de telefone do destinatário quando envia mensagens para os EUA e Canadá.
Estas funcionalidades estão ativadas por predefinição. Para as desativar, clique no botão de alternância.
Também pode adicionar mais números se não tiver selecionado vários números no passo anterior, clicando no botão Add Senders, ou eliminar um número já adicionado, clicando em Remove junto ao mesmo.
Selecione os números que configura e clique em Passo 3. Set up integration.
Passo 3. Configurar webhooks
Neste passo, tem de configurar webhooks para automatizar processos e sincronizar dados entre as suas contas Twilio e RemOnline.
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 URL de Callback:
A opção HTTP Post deve ser activada junto aos campos Request URL e Fallback URL.
Recomendamos que deixe o valor predefinido de 14400 no campo Validity period. O período de validade refere-se ao número de segundos durante os quais as mensagens enviadas a partir do 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 falha a mensagem e envia um pedido para o seu URL de retorno de chamada de status para notificar a sua aplicação da falha.
Para continuar, clique em Passo 4: Add compliance info.
Passo 4. Adicionar informações de conformidade
Importante: este passo só é necessário se estiver a utilizar um número dos EUA.
Isto pode ser feito através do registo para o A2P 10DLC (Código de 10 dígitos) nos Estados Unidos.
Trata-se de um sistema nos Estados Unidos que permite às empresas enviar mensagens de aplicação a pessoa (A2P) utilizando números de telefone de 10 dígitos (10DLC). O registo no A2P 10DLC através do Twilio envolve várias etapas:
configurar a sua conta;
registar a sua marca;
registar os seus casos de utilização;
registar os seus números de telefone.
O preenchimento do formulário demora alguns minutos se tiver preparado todas as informações necessárias.
A aprovação final do seu registo demora 1 a 2 semanas. Pode utilizar a Consola Twilio para verificar o status do seu registo US A2P 10DLC.
Pode finalizar a criação e a configuração do Serviço de Mensagens antes de o seu registo A2P 10DLC ser aprovado. Isto permite-lhe ter o seu sistema pronto a funcionar em pleno assim que o registo estiver concluído. Utilize este tempo para testar e configurar todos os componentes necessários para garantir que o seu serviço funciona sem problemas.
Tenha em atenção que, até o registo estar concluído, podem existir restrições quanto ao número e à frequência das mensagens que pode enviar e que o envio de grandes volumes de mensagens antes de o registo estar concluído pode resultar no bloqueio ou na redução da prioridade das mensagens.
Pode obter mais informações sobre o processo de registo A2P 10DLC aqui.
Para concluir a criação do serviço de mensagens, clique em Complete Messaging Service Setup.
Já está feito! O último passo é ligar-se ao RemOnline, após o que poderá utilizar o SMS para comunicar com os seus clientes.
Ligar ao RemOnline
Para ligar um número de SMS por Twilio ao RemOnline:
1. No painel do Twilio, vá para a secção Account Info. Aqui encontrará o Account SID e o Auth Token de que necessita para se ligar às conversas do RemOnline. Copie estas informações.
2. A seguir, vá a Messaging > Services e encontre o Messaging Service que criou. Copie o seu Sid.
3. No RemOnline, aceda a Configurações > Conversas e clique em + Canal. Selecione o recurso SMS by Twilio.
4. Preencha todos os campos:
Nome do canal - crie um nome para o seu canal de SMS que irá utilizar para comunicar com os clientes.
Account SID - cole o código Account SID copiado da sua conta Twilio.
Importante: se um canal com um SID de conta idêntico já estiver ligado por outra empresa, o sistema não lhe permite ligar um novo canal com o SID de conta no RemOnline. Para resolver este problema, é necessário eliminar a integração existente noutra empresa e, em seguida, adicionar um canal com este SID de conta ao RemOnline.
Token de autenticação - cole aqui o código do Token de autenticação copiado da sua conta Twilio.
Número de telefone - introduza o número de telefone que registou no Twilio e que irá utilizar para comunicar com os clientes.
Atenção: só pode ligar um canal por número. Ou seja, se já tiveres um canal de WhatsApp ligado ao mesmo número, não poderás criar um canal de SMS.
Serviço de Mensagens Sid - aqui precisa de colar o Código do Serviço de Mensagens Sid 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 da conversa, desde que esse acesso seja permitido pelo sistema;
Selecionados - apenas os funcionários selecionados terão acesso às Configurações da conversa, desde que autorizados pelo sistema;
Proprietário - somente o proprietário da empresa terá acesso às configurações.
Para alterar as definições de acesso dos funcionários às definições da Conversa e do Chat, aceda a Configurações > Funcionários > Funções e edite as definições necessárias.
6. Clique em Criar.
Já está feito! Agora pode conversar com os clientes através de SMS diretamente no RemOnline. Saiba mais sobre como as conversas funcionam aqui.