Conecte o Twilio ao seu app do MonstarX
ResumindoO Twilio envia SMS a partir de um número de telefone que você aluga dele. Cole o Account SID, o auth token e o seu número do Twilio em Backend → Nuvem e peça ao MonstarX as mensagens que você quer, como “mande um SMS de lembrete aos alunos na véspera da aula”.
Envie SMS e códigos de verificação, ou faça ligações.
- Tipo
- Para o seu app
- Categoria
- Mensagens, e-mail e ligações
- Conecte com
- Chave de API
O Twilio é um serviço de mensagens e chamadas telefônicas. Você aluga um número de telefone do Twilio, e o seu app envia mensagens de texto (SMS) a partir dele — do tipo que as pessoas realmente leem, muitas vezes em poucos minutos.
O que você pode criar com ele?
Seção intitulada “O que você pode criar com ele?”- Lembretes: “Sua aula começa amanhã às 7h.”
- Atualizações de pedido e entrega: “Seu pedido está pronto para retirada.”
- Códigos de acesso ou de confirmação enviados por SMS para um número de telefone.
- Alertas para a sua equipe, como um SMS para o gerente quando entra um pedido grande.
- Um botão “me mande o link por SMS” que envia uma página para o celular de alguém.
Antes de começar
Seção intitulada “Antes de começar”- Uma conta do Twilio. O Twilio cobra por mensagem e uma mensalidade pelo número; os preços dependem do país (veja os preços do Twilio).
- Um número de telefone do Twilio que possa enviar SMS.
- Contas de teste (trial) só conseguem enviar SMS para números que você verificou no Twilio, e só no país em que você criou a conta. Faça o upgrade da conta antes que clientes reais dependam das suas mensagens.
- Alguns países exigem que você registre o número ou a empresa antes de os SMS serem entregues (os Estados Unidos, por exemplo). O console do Twilio guia você nesse processo.
Pegue suas chaves
Seção intitulada “Pegue suas chaves”-
Entre no Twilio Console.
-
Na página inicial do console, copie o Account SID (começa com
AC) e o Auth Token. -
Pegue um número de telefone se ainda não tiver um (Phone Numbers → Buy a number, ou o número de teste que o Twilio oferece). Copie no formato internacional: sinal de mais, código do país e número, sem espaços — como
+61412345678.
Conecte no MonstarX
Seção intitulada “Conecte no MonstarX”-
Abra seu projeto e clique em Backend na barra superior e depois em Nuvem.
-
Em Conectores, clique em Conectar ao lado do Twilio.
-
Cole o Account SID em SID da conta, o Auth Token em Token de autenticação e o seu número do Twilio em Número de origem.
-
Clique em Conectar Twilio. A linha mostra Conectado e a prévia reinicia com as chaves.
Quando você pede primeiro uma funcionalidade de SMS, o MonstarX mostra os mesmos campos em um cartão no chat. Clique em Depois se ainda não tiver conta no Twilio: o MonstarX cria tudo, e a funcionalidade avisa que o Twilio não está conectado até você adicionar as chaves.
Peça ao MonstarX para usar
Seção intitulada “Peça ao MonstarX para usar”| Você digita | O que acontece |
|---|---|
| “Mande um SMS de lembrete aos alunos na véspera de cada aula que eles agendaram.” | Um campo de telefone no perfil e um lembrete enviado por SMS. |
| “Quando um pedido for marcado como pronto, mande um SMS para o cliente.” | Um SMS sai assim que você muda o status do pedido. |
| “Peça um número de telefone no cadastro e envie um código de 6 dígitos por SMS para confirmar.” | Um código é enviado por SMS e conferido antes de o número ser salvo. |
| “Me mande um SMS no +61412345678 sempre que alguém agendar uma sessão particular.” | Um SMS para o seu próprio celular a cada novo agendamento. |
Segurança e privacidade
Seção intitulada “Segurança e privacidade”- O auth token é secreto: ele fica guardado com criptografia e só o servidor do seu app o usa. O Account SID e o número de origem não são secretos, mas também ficam no servidor.
- Os números de telefone que o seu app coleta ficam no banco de dados do app, no mesmo formato internacional.
- Só o proprietário do projeto pode conectar, atualizar ou desconectar o Twilio. Desconectar remove as chaves deste app.
- Para trocar o token, crie um novo no Twilio Console, clique em Atualizar chaves na linha do Twilio, cole e clique em Salvar chaves. Publique de novo para o app no ar usar o token novo.
Bom saber
Seção intitulada “Bom saber”- Por padrão, o MonstarX cria mensagens de texto (SMS). O Twilio também envia mensagens no WhatsApp e faz chamadas de voz; peça por nome e configure isso antes no Twilio (o WhatsApp exige um remetente aprovado).
- As respostas dos clientes vão para o seu número do Twilio. Para fazer algo com elas, peça ao MonstarX para tratar os SMS recebidos e coloque o endereço que ele der nas configurações do seu número no Twilio.
- Cada mensagem custa dinheiro na sua conta do Twilio, inclusive as que a sua prévia envia enquanto você testa.
Perguntas frequentes
Seção intitulada “Perguntas frequentes”Por que o meu SMS de teste nunca chegou?
Em uma conta de teste (trial) do Twilio, você só consegue enviar SMS para números verificados no Twilio. Verifique o seu celular no Twilio Console ou faça o upgrade da conta.
Em que formato os números de telefone devem estar?
No formato internacional, com sinal de mais e sem espaços, como +61412345678. O MonstarX guarda do mesmo jeito os números que o seu app coleta.
Meu app pode enviar mensagens no WhatsApp?
Sim, pelo Twilio, depois que o seu remetente do WhatsApp estiver configurado no Twilio. Peça o WhatsApp ao MonstarX pelo nome.
O MonstarX cobra pelos SMS?
Não. O Twilio cobra cada mensagem na sua própria conta; o MonstarX não cobra nada a mais.