Integre com Twilio

O PlatoForms pode enviar mensagens de texto (SMS) para seus formulários: notificações de envio, convites, solicitações de documentos, renovações e tarefas de fluxo de trabalho. Por padrão, elas são enviadas através do PlatoForms SMS, que é pago com seu saldo de crédito e usa um texto fixo. Se você tiver uma conta Twilio, pode conectá-la e enviar essas mensagens através do seu próprio Twilio.

PlatoForms SMS ou seu próprio Twilio

Não tem uma conta Twilio? Você não precisa de uma: o PlatoForms SMS envia suas mensagens sem qualquer configuração, e uma empresa dos EUA ou Canadá pode se registrar lá para enviar mensagens para números dos EUA. Veja Enviar mensagens de texto (SMS). Os dois serviços são separados: registrar-se no PlatoForms não altera o que sua conta Twilio pode enviar.

Você conecta o Twilio uma vez para sua equipe. Depois disso, você escolhe o serviço em cada lugar que envia mensagens, então um formulário pode usar seu Twilio enquanto outro permanece no PlatoForms SMS.

Antes de começar: o que você precisa do Twilio

Recolha estes dados no Console Twilio:

1. Um Serviço de Mensagens com um remetente em seu pool. Vá para Mensagens > Serviços, abra ou crie um serviço e adicione um número de telefone ou um ID de remetente alfanumérico ao seu pool de remetentes. Copie o SID do Serviço de Mensagens (começa com MG).

2. Seu SID da Conta (começa com AC), mostrado em Informações da conta.

3. Uma chave de API padrão. Vá para Conta > Chaves de API & tokens, crie uma chave Padrão e copie seu SID (começa com SK) e seu segredo. O Twilio mostra o segredo apenas uma vez. Deixe o seletor de região em Estados Unidos (US1), o padrão. A região não limita os países para os quais você pode enviar mensagens.

Conecte sua conta Twilio

1. No Painel, passe o mouse sobre qualquer formulário, clique em Configurações (ícone de engrenagem) no canto superior direito, depois clique em Gerenciar Formulário.

   

2. Na barra lateral esquerda, clique em Integrações.

3. Encontre o cartão Twilio e clique em Conectar. A página de Mensagens de texto abre em uma nova aba do navegador, na aba Seu próprio Twilio.

   

   Note

   A conexão é para toda a sua equipe, então você faz isso uma vez, de qualquer formulário. Você também pode abrir a página em Plano e Cobrança > Saldo de crédito: clique em Configurações de mensagens de texto ao lado de Mensagens SMS, depois na aba Seu próprio Twilio.

4. Em Conecte seu Twilio, insira o SID da Conta, SID do Serviço de Mensagens, SID da Chave de API e segredo da chave de API, depois clique em Conectar.

   

   O PlatoForms verifica a conta, o Serviço de Mensagens e seus remetentes com essas credenciais. Nada é enviado. O segredo da chave de API é armazenado criptografado.

5. Quando a verificação for aprovada, Seu próprio Twilio mostrará Conectado, com os números ou IDs de remetente do seu Serviço de Mensagens.

   

6. (Opcional) Em Enviar um texto de teste, insira um número de celular e clique em Enviar texto de teste para confirmar a entrega. O Twilio cobra por este texto.

Use seu Twilio para os textos de um formulário

Conectar o Twilio não altera nada por si só. Cada seção de SMS continua usando o PlatoForms SMS até que você a altere.

1. Abra as configurações de SMS que você deseja alterar, por exemplo Gerenciar Formulário > Convites ou Gerenciar Formulário > Notificações, e ative o SMS.

2. Selecione Seu próprio Twilio.

   

3. Escreva a mensagem de texto. Clique em uma variável ao lado de Inserir para adicioná-la. O que o telefone mostra pré-visualiza a mensagem com valores de exemplo e informa seu comprimento e quantos textos ela é enviada como.

   

4. Salve suas alterações.

Você pode fazer essa escolha em cada um desses lugares:

Regras para seu próprio texto

• Um texto pode ter até 320 caracteres. Uma mensagem longa é enviada como vários textos; a pré-visualização mostra quantos.
• Use apenas as variáveis oferecidas para aquele texto. Onde o texto entrega um link (convites, solicitações de documentos, renovações e tarefas de fluxo de trabalho), ele deve conter {{ link }}.
• O PlatoForms adiciona uma linha de opt-out a cada texto: “Responda STOP para cancelar.” quando o remetente é um número de telefone, ou um link de opt-out quando é um ID de remetente alfanumérico, que não pode receber respostas. Se seu Serviço de Mensagens tiver ambos, o Twilio usa o ID de remetente alfanumérico onde o país permitir (em todos os lugares, exceto nos EUA e Canadá), então esses textos terminam com o link de opt-out.
• Um texto é verificado quando você o salva. Um texto que pede senhas, detalhes de pagamento ou informações pessoais não é aceito.
• Envie mensagens apenas para pessoas que concordaram em recebê-las. Limites diários por destinatário e por formulário ainda se aplicam, para proteger as pessoas que você envia mensagens.

Cobrança e uso

• As mensagens enviadas através do seu Twilio são cobradas pela Twilio na sua conta. O PlatoForms não cobra por elas, e elas não usam seu saldo de crédito.
• Elas ainda aparecem na página Uso sob SMS, a $0,00.
• Seções deixadas no PlatoForms SMS funcionam como antes e são pagas com seu saldo de crédito.

Substitua a chave de API ou desconecte

• Substituir a chave: crie uma nova chave de API no Twilio, abra a página de Mensagens de texto (clique em Configurar no cartão Twilio), e insira a chave em Reconectar seu Twilio.
• Desconectar: clique em Desconectar seu Twilio. O segredo da chave de API é removido do PlatoForms. Seções configuradas para Seu próprio Twilio voltam para o PlatoForms SMS com o texto padrão. Sua escolha e seus textos são mantidos, e são usados novamente quando você reconectar.
• Precisa de atenção: se o Twilio parar de aceitar a chave, por exemplo, após você revogá-la, a conexão mostrará Precisa de atenção e o proprietário da equipe receberá um e-mail. Até você reconectar, essas seções usam o PlatoForms SMS, que precisa de crédito no seu saldo.

Solução de problemas

Referências

• Twilio: Chaves de API

• Twilio: Serviços de Mensagens

• Converse com nossa equipe de suporte

• Política de Privacidade de Dados