# 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](#limitations) 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](sms.md). 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](https://sms-gate.app) — transfira-a a partir do site ou das suas [versões no GitHub](https://github.com/capcom6/android-sms-gateway/releases/latest). 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](#keeping-the-phone-reliable). - **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 1. Instale o **SMS Gateway for Android** a partir de [sms-gate.app](https://sms-gate.app) no telemóvel cujo número pretende utilizar. 2. Abra a aplicação. 3. 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). 4. A aplicação gera um **nome de utilizador** e uma **palavra-passe** no ecrã inicial. Irá colá-los na plataforma na secção seguinte. 5. (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. 6. Copie a **Signing Key**. Colá-la na plataforma adiciona uma verificação de assinatura extra nas mensagens recebidas. > **Modo local (avançado).** Se preferir que o telemóvel comunique diretamente com a plataforma através da sua própria rede em vez do reencaminhamento na nuvem, a aplicação também suporta o modo Local Server. Terá de expor o telemóvel num endereço HTTPS acessível e introduzir esse endereço como o URL base ao ligar. O modo Cloud é recomendado para quase todos os utilizadores. --- ## Ligar o telemóvel à plataforma 1. Na barra lateral esquerda, clique em **Definições** perto da parte inferior. 2. Na barra lateral esquerda de Definições, em **Canais**, clique em **Canais**. 3. Encontre o cartão **Android SMS Gateway** e clique em **Ligar**. 4. Introduza o **Número de telefone** — o próprio número do telemóvel no formato internacional (E.164), por exemplo, `+14155551234`. 5. Introduza o **Nome de utilizador do gateway** e a **Palavra-passe do gateway** a partir do ecrã inicial da aplicação de gateway. 6. Opcionalmente, cole a **Chave de assinatura do webhook** (recomendado) a partir das definições de Webhooks da aplicação. 7. 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 1. Alguém envia uma mensagem para o número do seu telemóvel. 2. A aplicação gateway no telemóvel deteta o SMS e notifica a plataforma. 3. 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 1. Você ou a IA enviam uma resposta a partir da plataforma. 2. A plataforma entrega a mensagem ao seu gateway. 3. O telemóvel envia-a como um SMS normal a partir do seu número, através da sua operadora. 4. À 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 qualquer dos casos: **as campanhas e os envios em massa de SMS 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, sem mensagens. Mantenha-o carregado, ligado ao Wi-Fi ou a dados e excluído da otimização de bateria. - **Apenas baixo volume.** As operadoras sinalizam e limitam telemóveis que enviam subitamente muitas mensagens. Este canal destina-se a conversas e respostas individuais — **não a envios 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 Twilio. Realize os envios através do Twilio e mantenha o gateway Android para respostas conversacionais. - **Apenas texto.** O envio e receção de MMS (multimédia) não é suportado neste canal. - **Aplicam-se os limites da operadora.** O plafond de SMS do seu plano, os limites de utilização responsável e quaisquer custos por mensagem são da responsabilidade da sua operadora. - **A confirmação de entrega depende da sua operadora.** Algumas operadoras reportam a entrega de forma fiável; outras não. Um estado "Sent" significa que o telemóvel enviou a mensagem. - **Risco para a conta/número.** A utilização de um número pessoal para mensagens de negócio automatizadas pode violar os termos da sua operadora e levar a que o número seja limitado ou suspenso 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 internet e que o modo **Cloud Server** está ligado na aplicação. ### 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.