Addon Twilio

Você gostaria de enviar mensagens SMS e WhatsApp quando formulários forem enviados em seu site WordPress? Com o add-on Twilio do WPForms, você pode enviar automaticamente notificações por SMS e WhatsApp quando os formulários forem preenchidos.

Este tutorial mostrará como instalar e usar o add-on Twilio com o WPForms.

---

Configurando Sua Conta Twilio

Antes de configurar o add-on Twilio no WPForms, você precisará criar e configurar sua conta Twilio. O processo envolve a criação da sua conta, a verificação da sua identidade e a obtenção de um número de telefone para envio de mensagens. Se você já tem uma conta Twilio configurada, pode pular para a seção Conectando o WPForms ao Twilio.

Primeiro, navegue até o site da Twilio e crie uma conta. Você precisará fornecer algumas informações básicas para começar.

Após o cadastro, a Twilio o guiará pelo processo de configuração da sua conta. Isso inclui a verificação da sua identidade com um número de telefone onde você pode receber um código de verificação. Insira seu número de telefone e a Twilio enviará um código via SMS.

Após inserir o código de verificação, você será levado ao painel do seu Console Twilio. É aqui que você encontrará todas as ferramentas e configurações necessárias para integrar o Twilio ao WPForms.

Comprando um Número de Telefone Twilio

Para enviar mensagens através da sua integração com o WPForms, você precisará comprar um número de telefone Twilio dedicado. No seu Console Twilio, vá para Números de Telefone » Gerenciar » Comprar um número no menu de navegação à esquerda.

Aqui, você verá opções para pesquisar números de telefone disponíveis. Você pode pesquisar por códigos de área específicos ou padrões de números usando as opções de pesquisa na parte superior da página.

Assim que encontrar um número adequado, clique no botão Comprar ao lado dele.

Uma janela de confirmação aparecerá mostrando as capacidades do número e a taxa mensal. Clique em Comprar para concluir sua compra. Durante o teste gratuito, a Twilio fornece US$ 15 em crédito que você pode usar para comprar seu número de telefone e enviar mensagens.

Para obter detalhes abrangentes sobre como pesquisar e comprar números de telefone na Twilio, consulte o guia oficial da Twilio.

Criando Modelos de Mensagem

Modelos de mensagem ajudam você a padronizar suas notificações do WhatsApp e torná-las mais dinâmicas, incluindo dados de envio de formulário. Você pode criar modelos que inserem automaticamente informações dos campos do seu formulário.

Para configurar modelos de mensagem, vá para Mensagens » Construtor de Modelos de Conteúdo no menu da barra lateral esquerda no seu Console Twilio.

Em seguida, clique no botão Criar seu primeiro modelo de conteúdo.

Após clicar no botão, você verá o formulário de criação de modelo, onde precisará fornecer vários detalhes importantes:

• Nome do Modelo: Insira um nome descritivo que indique claramente o propósito do modelo. Este campo só pode conter caracteres alfanuméricos minúsculos e sublinhados.
• Idioma do Modelo: Selecione o idioma que deseja usar para suas mensagens nas opções disponíveis.
• Tipo de Conteúdo: Neste campo, você verá várias opções para formatar sua mensagem. Selecione o tipo que melhor se adapta às suas necessidades, dependendo se você deseja enviar mensagens de texto simples, incluir mídia, adicionar elementos interativos ou criar layouts mais estruturados.
  • Para o nosso exemplo, selecionaremos o Tipo de Conteúdo Texto.

Depois de adicionar esses detalhes, clique no botão Criar para ir para a próxima etapa.

Em seguida, você será levado à página de configuração do modelo. Aqui você verá opções para personalizar o conteúdo do seu modelo. Role para baixo até a seção Conteúdo e, no campo Corpo, insira o texto da sua mensagem.

Para tornar suas mensagens dinâmicas, você pode adicionar variáveis que serão substituídas por dados reais do formulário quando a mensagem for enviada. Para adicionar uma variável, clique no botão Adicionar Variável abaixo do campo Corpo.

As variáveis usam chaves duplas com números, como: “Olá {{1}}! Obrigado pelo seu pedido número {{2}}.”

Após inserir sua mensagem, clique em Salvar e enviar para aprovação do WhatsApp.

Você verá uma janela pop-up pedindo para fornecer valores de exemplo para cada variável que você usou. Esses valores de exemplo ajudam o WhatsApp a entender como seu modelo será usado.

Insira o texto de exemplo apropriado para cada variável e clique em Salvar com exemplos para concluir o processo de criação do modelo.

Para obter detalhes abrangentes sobre a criação de modelos de mensagens, opções de formatação e melhores práticas, consulte o guia oficial da Twilio sobre como configurar modelos de mensagens do WhatsApp.

Conectando o WPForms ao Twilio

Com o plugin principal do WPForms instalado e sua licença verificada, prossiga e instale e ative o addon do Twilio.

Para conectar sua conta Twilio ao WPForms, vá para WPForms » Configurações e clique na guia Integrações.

Em seguida, clique na opção Twilio para expandir suas configurações. A partir daqui, clique no botão Adicionar Nova Conta.

Isso revelará dois campos onde você precisará adicionar seu SID da Conta Twilio e Token de Autenticação, bem como um apelido para a conta.

Mantenha esta aba do navegador aberta, pois retornaremos a ela mais tarde.

Acessando Suas Credenciais Twilio

Para encontrar suas credenciais, primeiro, faça login no seu Console Twilio. Depois de fazer login, localize a seção Informações da Conta no seu painel.

Esta seção contém duas informações importantes de que você precisará: seu SID da Conta e Token de Autenticação. Certifique-se de copiar ambas as credenciais clicando no ícone de cópia.

Adicionando Credenciais Twilio ao WPForms

Após copiar sua chave SID da Conta, retorne à aba do navegador com o WPForms aberto e cole a chave que você acabou de copiar no campo SID da Conta Twilio.

Da mesma forma, você precisará copiar seu Token de Autenticação do Twilio e colá-lo no campo Token de Autenticação Twilio.

Em seguida, adicione um apelido ao campo Nome da Conta Twilio. Isso é apenas para referência interna e pode ser útil se você decidir mais tarde conectar contas Twilio adicionais.

Quando estiver pronto, clique no botão Conectar ao Twilio.

O WPForms agora conectará seu site à sua conta Twilio. Quando terminar de conectar, ele mostrará um status verde Conectado ao lado da sua integração Twilio.

Usando o Twilio Com Seus Formulários

Agora que você conectou com sucesso o WPForms à sua conta Twilio, poderá vincular o Twilio aos seus formulários. Para fazer isso, primeiro você precisará criar um novo formulário ou editar um existente para acessar o construtor de formulários.

No construtor de formulários, vá para Marketing » Twilio. Em seguida, clique no botão Adicionar Nova Conexão.

Em seguida, uma sobreposição aparecerá onde você pode inserir um apelido de conexão. Sinta-se à vontade para usar qualquer apelido que desejar, pois ele não será visível para seus usuários. Depois de adicionar um apelido, clique no botão OK.

Depois de nomear sua conexão, você precisará escolher a conta que conectou no menu suspenso Selecionar Conta.

Após selecionar uma conta, você verá várias opções de configuração.

Enviar Como

Escolha como você deseja enviar suas notificações. Você pode selecionar SMS ou WhatsApp. Sua seleção aqui determinará algumas das opções adicionais que aparecem abaixo.

Enviar De

Escolha quais dos seus números de telefone Twilio devem ser usados para enviar a mensagem. Este menu suspenso exibirá todos os números de telefone que você comprou em sua conta Twilio.

Enviar Para

Especifique quem deve receber as notificações. Você pode selecionar entre duas opções:

• Campos de Telefone: Selecione esta opção para enviar mensagens aos remetentes do seu formulário.
• Número de Telefone Verificado: Escolha esta opção para enviar notificações para um número de telefone específico que você verificou anteriormente em sua conta Twilio.

Campo de Telefone

Neste menu suspenso, selecione o campo do formulário que contém o número de telefone do destinatário.

Número de Telefone Verificado

Neste menu suspenso, escolha em sua lista de números de telefone verificados em sua conta Twilio.

Mensagem

Este campo aparece quando SMS é selecionado no campo Enviar Como. Aqui, insira o texto que você gostaria de enviar. Você pode clicar no botão Mostrar Tags Inteligentes ao lado deste campo para incluir conteúdo dinâmico, como valores de campos de formulário, em sua mensagem.

Modelo de Mensagem

Este campo aparece quando WhatsApp é selecionado no campo Enviar Como. Aqui, selecione um dos modelos que você criou anteriormente na seção Modelos de Mensagem. Isso é necessário para a conformidade de mensagens do WhatsApp Business.

Variáveis do Modelo

Após selecionar um modelo de mensagem do WhatsApp que contém variáveis, você verá uma seção Variáveis do Modelo aparecer. Aqui, você pode mapear seus campos de formulário para as variáveis em seu modelo.

Para cada variável em seu modelo, você verá um menu suspenso correspondente onde pode selecionar qual valor de campo de formulário deve substituir essa variável quando a mensagem for enviada.

Por exemplo, se sua mensagem modelo for “Olá {{1}}! Obrigado pelo seu número de pedido {{2}}“, você iria:

• Mapear a variável 1 para um campo de formulário contendo o nome do cliente.
• Mapear a variável 2 para um campo de formulário contendo o número do pedido.

Este mapeamento garante que suas mensagens do WhatsApp incluam automaticamente as informações corretas de seus envios de formulário.

Quando terminar de configurar a conexão Twilio do seu formulário, clique em Salvar no topo do construtor de formulários.

Habilitando o Sandbox para Testes do WhatsApp (Opcional)

Se você quiser testar o envio de mensagens pelo WhatsApp antes de configurar uma conta completa do WhatsApp Business, pode usar o ambiente Sandbox da Twilio. Isso permite que você teste sua integração sem a necessidade de aprovação do WhatsApp.

Para fazer isso, você precisará conectar seu número de telefone ao Sandbox do WhatsApp da Twilio. Para fazer isso, faça login no seu Console Twilio e navegue até Mensagens » Experimente » Enviar uma mensagem do WhatsApp na barra lateral esquerda.

Na página de testes do WhatsApp, role para baixo até a seção Conectar ao Sandbox do WhatsApp, onde você verá seus detalhes exclusivos de conexão do Sandbox, incluindo um número de telefone Twilio (+14155238886) e um código de entrada. Você pode se conectar ao Sandbox enviando seu código de entrada para este número via WhatsApp ou escaneando o código QR exibido na página com o aplicativo WhatsApp do seu telefone.

Após enviar o código de entrada, você receberá uma mensagem de confirmação indicando que seu número de telefone agora está conectado ao Sandbox e pronto para testes.

Depois de conectar seu número de telefone ao Twilio Sandbox, você pode configurar o WPForms para usá-lo. Abra seu formulário no construtor de formulários e vá para as configurações de conexão do Twilio, selecione WhatsApp no menu suspenso Enviar Como para revelar a opção Ativar Modo Sandbox.

Quando você ativa esta opção, ela modifica como suas mensagens do WhatsApp são tratadas. Em vez de exigir um modelo de mensagem pré-aprovado, você verá um campo Mensagem onde poderá inserir qualquer texto personalizado que desejar usar.

O complemento enviará suas mensagens usando o número de teste da Twilio (+14155238886), permitindo que você teste sua integração do WhatsApp sem uma conta do WhatsApp Business.

Lembre-se de salvar seu formulário após ativar o modo sandbox e configurar o texto da sua mensagem no campo Mensagem.

Configurando Lógica Condicional (Opcional)

Lógica condicional permite que você escolha se uma ação é realizada ou não com base nas escolhas de um usuário em seu formulário. Como exemplo, mostraremos como você pode usar a lógica condicional para enviar mensagens através do método de notificação preferido de um usuário, criando duas conexões Twilio separadas – uma para SMS e outra para notificações do WhatsApp.

Para configurar isso, você precisará primeiro criar duas conexões Twilio seguindo as etapas descritas acima. Configure uma conexão para enviar mensagens SMS e outra para enviar mensagens do WhatsApp.

Em seguida, adicione um campo de Múltiplas Escolhas ao seu formulário. Para nosso exemplo, definiremos o rótulo como Como você gostaria de ser notificado? e adicionaremos duas opções: SMS e WhatsApp.

Em seguida, vá para Marketing » Twilio no construtor de formulários e ative a opção Ativar Lógica Condicional . Em seguida, você precisará configurar suas regras para a lógica condicional.

Para a conexão SMS, defina a regra como: Processar esta conexão se Como você gostaria de ser notificado? for SMS.

Para a conexão do WhatsApp, defina-a como: Processar esta conexão se Como você gostaria de ser notificado? for WhatsApp.

Finalmente, certifique-se de salvar seu formulário para aplicar a lógica condicional.

Com esta configuração, quando os usuários preencherem seu formulário, eles receberão automaticamente notificações através do método preferido deles – seja SMS ou WhatsApp – com base na seleção deles no formulário.

Perguntas Frequentes

Abaixo, respondemos a algumas das principais perguntas que recebemos sobre o addon Twilio.

Por que minhas mensagens do WhatsApp pararam de funcionar no modo Sandbox?

Ao testar mensagens do WhatsApp usando o modo Sandbox, você tem um período de teste de três (3) dias após conectar seu número de telefone inicialmente. Após o término desse período, suas mensagens pararão de ser enviadas. Para continuar testando, basta se reconectar ao Sandbox seguindo as etapas na seção Ativando o Sandbox para Testes do WhatsApp acima.

Posso visualizar o status de entrega e os logs das minhas mensagens?

Sim, você pode rastrear o status e os logs das mensagens tanto no WPForms quanto no Twilio Console.

Dentro do WPForms, você pode visualizar o status de entrega e os logs das mensagens diretamente em WPForms » Ferramentas e abrindo a guia Logs.

Para mais detalhes sobre o registro de logs do WPForms, consulte nosso guia sobre como ativar o registro de atividades.

Adicionalmente, no Twilio Console, vá para Monitorar » Logs » Mensagens Programáveis para visualizar logs detalhados de mensagens, incluindo status de entrega, carimbo de data/hora, conteúdo, informações do destinatário e quaisquer erros.

Para informações mais detalhadas sobre logs de mensagens, consulte o guia oficial da Twilio sobre logs de mensagens.

É isso! Acabamos de mostrar como instalar e usar o addon Twilio com o WPForms.

Em seguida, você gostaria de adicionar um CAPTCHA aos seus formulários para ajudar a prevenir envios de spam? Certifique-se de conferir nosso tutorial sobre como escolher um CAPTCHA para seus formulários para mais detalhes.