Telemóvel Android como Gateway de SMS (Beta)
Utilize o seu próprio telemóvel Android como emissor de SMS. Em vez de ligar uma conta Twilio, instala uma pequena aplicação de código aberto num telemóvel Android, emparelha-a com o seu espaço de trabalho e as suas mensagens são enviadas e recebidas através do número e do plano de operador desse telemóvel.
Canal Beta. O gateway de SMS para Android está agora disponível para todos os utilizadores com um plano que inclua uma quota de canais, mas ainda é uma funcionalidade recente — espere algumas imperfeições ocasionais e tenha em atenção que o comportamento e os limites poderão sofrer alterações à medida que o canal amadurece. Se algo não funcionar conforme descrito, informe a equipa de suporte.
Porquê utilizar isto
O gateway Android foi criado para SMS de baixo volume e conversacionais — responder a leads, conversas com IA e mensagens individuais. É uma boa opção quando:
- Pretende continuar a enviar mensagens a partir do seu número pessoal ou profissional existente.
- O Twilio é excessivo ou tem um preço desadequado para o seu país ou volume.
- Prefere utilizar o plafond de SMS existente do seu operador em vez de pagar taxas por mensagem.
- Quer evitar a burocracia de registo de operador (A2P 10DLC e semelhantes) que o Twilio exige.
Não foi criado para envios em massa — consulte as Limitações abaixo.
Prefira o Twilio para escala e fiabilidade. Se envia em volume, precisa de tempo de atividade garantido ou realiza envios de SMS em massa, ligue um número Twilio — consulte SMS Messaging. Ambos são transportes de SMS alternativos; as mensagens, contactos, a IA e a sua caixa de entrada funcionam da mesma forma em qualquer um deles.
O que precisa
- Um telemóvel Android com um cartão SIM ativo e um plano de SMS (recomenda-se vivamente um plano de SMS ilimitado ou generoso).
- A aplicação gratuita e de código aberto “SMS Gateway for Android” a partir de sms-gate.app — transfira-a a partir do site ou das suas versões no GitHub. Não somos os criadores desta aplicação — é um projeto de terceiros.
- O telemóvel mantido ligado, online e sem restrições — consulte Manter o telemóvel fiável.
- Um plano pago — o gateway Android está incluído na sua franquia de canais.
Não existe taxa de plataforma por mensagem nem fatura da Twilio — utiliza o plano da sua operadora móvel. Se a IA gerar uma resposta, essa resposta consome créditos de IA, tal como em qualquer outro canal.
Configurar a aplicação Gateway
- Instale o SMS Gateway for Android a partir de sms-gate.app no telemóvel cujo número pretende utilizar.
- Abra a aplicação.
- Ative o modo Cloud Server (a opção mais simples — reencaminha através do servidor alojado do projeto, pelo que o seu telemóvel não precisa de um endereço público).
- A aplicação gera um nome de utilizador e uma palavra-passe no ecrã inicial. Irá colá-los na plataforma na secção seguinte.
- (Recomendado) Na aplicação, abra Settings → Webhooks. Um webhook é uma notificação automática que a aplicação envia para a plataforma sempre que algo acontece — neste caso, sempre que chega uma mensagem.
- Copie a Signing Key. Colá-la na plataforma adiciona uma verificação de assinatura extra nas mensagens recebidas.
Apenas no modo Cloud Server. A janela de ligação funciona com o modo Cloud Server da própria aplicação. Um telemóvel configurado para o modo Local Server, ou ligado a um servidor diferente (um retransmissor privado ou de terceiros), não pode ser ligado: o seu ID de dispositivo, token de registo ou o início de sessão desse servidor são rejeitados como nome de utilizador ou palavra-passe inválidos. Mude o telemóvel para o modo Cloud Server e utilize o nome de utilizador e a palavra-passe do ecrã inicial da aplicação.
Ligar o telemóvel à plataforma
- Na barra lateral esquerda, clique em Definições perto da parte inferior.
- Na barra lateral esquerda de Definições, em Canais, clique em Canais.
- Encontre o cartão Android SMS Gateway e clique em Ligar.
- Introduza o Número de telefone — o próprio número do telemóvel no formato internacional (E.164), por exemplo,
+14155551234. - Introduza o Nome de utilizador do gateway e a Palavra-passe do gateway a partir do ecrã inicial da aplicação de gateway.
- Opcionalmente, cole a Chave de assinatura do webhook (recomendado) a partir das definições de Webhooks da aplicação.
- Clique em Ligar.
A plataforma valida as credenciais, regista os webhooks de mensagem e de entrega no gateway por si e altera o estado para Ligado. Não é necessário copiar e colar URLs de webhook na aplicação — o registo é automático.
Verificar o estado
Uma vez ligado, o botão do cartão muda de Connect para Manage. Clique nele para reabrir o painel do gateway, onde encontrará Refresh status a qualquer momento. Este verifica novamente se o gateway está acessível e mostra se o telemóvel está atualmente online. Se o telemóvel estiver em modo de suspensão ou offline, verá um indicador claro de offline para saber que as mensagens não serão enviadas até que este volte a estar disponível.
Desligar
Clique em Manage no cartão para reabrir o painel do gateway e, em seguida, clique em Disconnect. A plataforma remove os webhooks que registou no gateway e termina a ligação. As suas mensagens passarão então a ser enviadas através do Twilio, caso tenha um número SMS Twilio ligado, ou o serviço de SMS será desativado caso não o tenha.
Como fluem as mensagens
Recebidas
- Alguém envia uma mensagem para o número do seu telemóvel.
- A aplicação gateway no telemóvel deteta o SMS e notifica a plataforma.
- A plataforma cria um contacto (se for novo), coloca a mensagem na sua caixa de entrada e — se o Agente de IA relevante estiver ativo — responde.
Enviadas
- Você ou a IA enviam uma resposta a partir da plataforma.
- A plataforma entrega a mensagem ao seu gateway.
- O telemóvel envia-a como um SMS normal a partir do seu número, através da sua operadora.
- À medida que a operadora reporta o estado, a mensagem é atualizada para Sent (Enviada) e, depois, Delivered (Entregue) (ou Failed - Falhou).
O gateway Android tem prioridade para o envio. Enquanto estiver ligado, as respostas individuais e de IA passam pelo seu telemóvel. Se também tiver um número SMS Twilio ligado, desligue o gateway Android para voltar a enviar através da Twilio. Uma exceção em ambos os casos: os envios de SMS em massa (broadcast) passam sempre pelo seu número Twilio, nunca pelo telemóvel Android — o envio em massa a partir de um dispositivo pessoal é precisamente o que leva ao bloqueio de números, pelo que a plataforma não o faz.
Limitações
O gateway Android depende de um telemóvel físico que controla, pelo que acarreta limitações que não encontrará no Twilio. Reveja-as antes de confiar nele para mensagens importantes.
- O telemóvel deve permanecer ligado e online. Sem telemóvel, não há mensagens. Mantenha-o carregado, ligado ao Wi-Fi ou a dados móveis e excluído da otimização de bateria.
- Apenas volume baixo. As operadoras sinalizam e limitam telemóveis que enviam subitamente muitas mensagens. Este canal destina-se a conversas e respostas individuais — não a transmissões em massa.
- Envios de SMS em massa não são suportados neste canal. Os envios de SMS em massa requerem um número Twilio ligado; a plataforma irá avisá-lo se tentar iniciar um sem o Twilio. Utilize o Twilio para transmissões e mantenha o gateway Android para respostas conversacionais.
- Apenas texto. As mensagens MMS recebidas, incluindo mensagens de chat RCS que o telemóvel recebe como MMS, chegam com o seu texto, mas quaisquer fotografias, vídeos ou ficheiros nelas contidos não são recebidos. O envio de MMS (multimédia) não é suportado neste canal.
- Aplicam-se os limites da operadora. O plafond de SMS do seu plano de telemóvel, os limites de utilização responsável e quaisquer custos por mensagem são da sua responsabilidade e da sua operadora.
- A confirmação de entrega depende da sua operadora. Algumas operadoras comunicam a entrega de forma fiável; outras não. Um estado “Enviado” significa que o telemóvel despachou a mensagem.
- Risco para a conta / número. A utilização de um número pessoal para envio de mensagens de negócio automatizadas pode violar os termos da sua operadora e levar à limitação ou suspensão do número em caso de abuso. Utilize-o de forma responsável, obtenha consentimento e inclua instruções de opt-out.
Manter o telemóvel fiável
Para manter as mensagens a fluir sem interrupções:
- Desative a otimização da bateria para a aplicação SMS Gateway (Definições do Android → Aplicações → SMS Gateway → Bateria → Sem restrições). Caso contrário, o Android poderá encerrá-la em segundo plano.
- Mantenha o ecrã acessível / a aplicação autorizada a correr em segundo plano. Um telemóvel dedicado deixado ligado à corrente é o ideal.
- Mantenha uma ligação Wi-Fi ou de dados estável. Se o telemóvel perder a conectividade, os envios ficam na fila ou falham até que a ligação seja restabelecida.
- Mantenha o cartão SIM ativo e em situação regular junto da sua operadora.
Resolução de Problemas
“Não foi possível validar as credenciais do gateway”
- Verifique novamente o nome de utilizador e a palavra-passe no ecrã inicial da aplicação gateway — estes são regenerados se reinstalar ou repor a aplicação.
- Confirme que o telemóvel tem acesso à Internet e que o modo Cloud Server está ativado na aplicação.
- Utilize o nome de utilizador e a palavra-passe do ecrã inicial da aplicação, e não um ID de dispositivo, um token de registo ou um início de sessão para outro servidor.
O estado mostra offline / as mensagens não estão a ser enviadas
- Abra a aplicação no telemóvel e confirme que está em execução e ligada ao servidor na nuvem.
- Verifique se o telemóvel não está em modo de poupança de bateria e se a aplicação está excluída da otimização de bateria.
- Toque em Refresh status no cartão após voltar a ligar o telemóvel.
As mensagens recebidas não aparecem
- Confirme se a ligação ainda indica Ligado (toque em Atualizar estado).
- Envie uma mensagem de teste para o número do telemóvel a partir de outro telemóvel.
- Certifique-se de que a aplicação de Mensagens predefinida do telemóvel não está a bloquear ou a filtrar o remetente.
Uma mensagem apresenta “Falha”
- A operadora rejeitou a mensagem — verifique se o número do destinatário é válido e está no formato internacional.
- Confirme se o seu cartão SIM ainda tem saldo de SMS e se o número não está suspenso.
- Taxas de envio muito elevadas podem ativar a limitação da operadora; reduza a velocidade e mantenha o volume baixo.
Precisa de ajuda?
O gateway de SMS para Android está em Beta. Se encontrar algo que não esteja aqui coberto, contacte hi@youraiconnector.com com:
- O número de telemóvel que ligou (não a palavra-passe).
- Se a aplicação de gateway indica que está online no telemóvel.
- Uma descrição do problema e quando aconteceu.
Analisaremos a situação assim que possível.