📱 SMS via Twilio
O PulseHub envia e recebe mensagens SMS através do Twilio, uma das APIs de SMS mais amplamente disponíveis globalmente.
Pré-requisitos
- Uma conta Twilio — teste gratuito disponível em twilio.com
- Um número de telefone Twilio com capacidade de SMS (adquirido pelo console do Twilio)
Passos de Configuração
1. Obter Suas Credenciais Twilio
Faça login no Twilio Console e anote:
| Credencial | Onde Encontrar |
|---|---|
| Account SID | Página inicial do console, em "Account Info" |
| Auth Token | Página inicial do console, clique em "Show" ao lado do Auth Token |
| From Number | Phone Numbers → Manage → Active Numbers — copie seu número Twilio no formato E.164 (ex. +15551234567) |
2. Adicionar o Canal no PulseHub
- Vá para Canais → Adicionar Canal
- Selecione SMS (Twilio)
- Insira Account SID, Auth Token e From Number
- Clique em Salvar Canal
- Copie a URL do Webhook
3. Configurar o Webhook no Twilio
- No Console do Twilio, vá para Phone Numbers → Manage → Active Numbers
- Clique no seu número de telefone
- Role até Messaging Configuration
- Em "A message comes in", selecione Webhook e cole sua URL de webhook do PulseHub
- Método: HTTP POST
- Clique em Save
4. Testar
Envie um SMS para seu número Twilio. Ele deve aparecer como uma nova conversa no PulseHub em segundos.
Limitações do Teste Gratuito do Twilio
Em uma conta de teste gratuito:
- Você só pode enviar SMS para números de telefone verificados
- Suas mensagens enviadas terão um prefixo promocional do Twilio
- Há um saldo de crédito limitado
Atualize para uma conta Twilio paga para enviar para qualquer número sem restrições.
Problemas Comuns
| Sintoma | Causa Provável |
|---|---|
| Nenhuma mensagem de entrada no PulseHub | URL do webhook não configurada no console do Twilio, ou URL incorreta |
| Erro "Unverified number" ao enviar | Teste gratuito — verifique o número do destinatário ou faça upgrade |
| Mensagens duplicadas | A deduplicação por MessageSid deve prevenir isso; verifique messages.external_id |