# Celular Android como Gateway de SMS (Beta) Use seu próprio celular Android como um remetente de SMS. Em vez de conectar uma conta Twilio, você instala um pequeno aplicativo de código aberto em um celular Android, emparelha-o com seu workspace, e suas mensagens são enviadas e recebidas através do número e do plano da operadora desse celular. > **Canal Beta.** O gateway de SMS para Android agora está disponível para todos em um plano com permissão de canal, mas ainda é novo — espere algumas imperfeições ocasionais e observe que o comportamento e os limites podem mudar à medida que o canal amadurece. Se algo não funcionar como descrito, informe o suporte. --- ## Por que usar isso O gateway Android foi criado para **SMS de baixo volume e conversacionais** — responder a leads, conversas com IA e mensagens um a um. É uma boa opção quando: - Você deseja continuar enviando mensagens a partir do seu **número pessoal ou comercial existente**. - O Twilio é **exagerado ou caro demais** para o seu país ou volume. - Você prefere usar a **franquia de SMS existente da sua operadora** em vez de pagar taxas por mensagem. - Você quer **evitar a burocracia de registro da operadora** (A2P 10DLC e similares) que o Twilio exige. Ele **não** foi criado para disparos em massa — veja as [Limitações](#limitations) abaixo. > **Prefira o Twilio para escala e confiabilidade.** Se você envia em volume, precisa de tempo de atividade garantido ou realiza disparos de SMS em massa, conecte um número Twilio — veja [SMS Messaging](sms.md). Ambos são transportes de SMS alternativos; mensagens, contatos, a IA e sua caixa de entrada funcionam da mesma forma em ambos. --- ## O que você precisa - **Um celular Android** com um chip SIM ativo e um plano de SMS (recomenda-se fortemente um plano ilimitado ou com uma franquia generosa de SMS). - **O aplicativo gratuito e de código aberto "SMS Gateway for Android"** disponível em [sms-gate.app](https://sms-gate.app) — baixe-o pelo site ou pelas [versões do GitHub](https://github.com/capcom6/android-sms-gateway/releases/latest). Nós não desenvolvemos este aplicativo — ele é um projeto de terceiros. - **O celular deve ser mantido ligado, conectado à internet e sem restrições** — veja [Mantendo o celular confiável](#keeping-the-phone-reliable). - **Um plano pago** — o gateway Android está incluído na sua franquia de canais. Não há **taxa de plataforma por mensagem** e nem fatura do Twilio — você usa o plano da operadora do seu próprio telefone. Se a IA gerar uma resposta, essa resposta ainda consome créditos de IA, da mesma forma que em qualquer outro canal. --- ## Configurando o aplicativo Gateway 1. Instale o **SMS Gateway for Android** a partir de [sms-gate.app](https://sms-gate.app) no telefone cujo número você deseja usar. 2. Abra o aplicativo. 3. Ative o modo **Cloud Server** (a opção mais simples — ele retransmite através do servidor hospedado do projeto, para que seu telefone não precise de um endereço público). 4. O aplicativo gera um **nome de usuário** e uma **senha** na tela inicial. Você os colará na plataforma na próxima seção. 5. (Recomendado) No aplicativo, abra **Settings → Webhooks**. Um webhook é uma notificação automática que o aplicativo envia para a plataforma sempre que algo acontece — neste caso, sempre que uma mensagem chega. 6. Copie a **Signing Key**. Colá-la na plataforma adiciona uma verificação de assinatura extra nas mensagens recebidas. > **Modo local (avançado).** Se você preferir que o celular se comunique com a plataforma diretamente pela sua própria rede em vez de usar o retransmissor na nuvem, o aplicativo também suporta o modo Local Server. Você precisará expor o celular em um endereço HTTPS acessível e inserir esse endereço como a URL base ao conectar. O modo Cloud é recomendado para quase todos. --- ## Conectando o celular à plataforma 1. Na barra lateral esquerda, clique em **Settings** perto da parte inferior. 2. Na barra lateral de configurações, em **Channels**, clique em **Channels**. 3. Encontre o cartão **Android SMS Gateway** e clique em **Connect**. 4. Insira o **Phone number** — o próprio número do telefone no formato internacional (E.164), por exemplo, `+14155551234`. 5. Insira o **Gateway username** e a **Gateway password** da tela inicial do aplicativo do gateway. 6. Opcionalmente, cole a **Webhook signing key** (recomendado) das configurações de Webhooks do aplicativo. 7. Clique em **Connect**. A plataforma valida as credenciais, registra os webhooks de mensagem e entrega no gateway para você e altera o status para **Conectado**. Não é necessário copiar e colar URLs de webhook no aplicativo — o registro é automático. ### Verificando o Status Uma vez conectado, o botão do cartão muda de **Connect** para **Manage**. Clique nele para reabrir o painel do gateway, onde você encontrará **Refresh status** a qualquer momento. Ele verifica novamente se o gateway está acessível e mostra se o telefone está atualmente **online**. Se o telefone estiver em repouso ou offline, você verá um indicador claro de offline para saber que as mensagens de texto não serão enviadas até que ele retorne. ### Desconectando Clique em **Manage** no cartão para reabrir o painel do gateway e, em seguida, clique em **Disconnect**. A plataforma remove os webhooks que registrou no gateway e limpa a conexão. Suas mensagens de texto então voltarão a usar o Twilio, caso você tenha um número SMS do Twilio conectado, ou o SMS será desativado se não tiver. --- ## Como as Mensagens Fluem ### Recebimento 1. Alguém envia uma mensagem para o número do seu telefone. 2. O aplicativo gateway no telefone detecta o SMS e notifica a plataforma. 3. A plataforma cria um contato (se for novo), coloca a mensagem na sua caixa de entrada e — se o Agente de IA relevante estiver ativo — ele responde. ### Envio 1. Você ou a IA enviam uma resposta a partir da plataforma. 2. A plataforma entrega a mensagem ao seu gateway. 3. O telefone a envia como um SMS normal do seu número, através da sua operadora. 4. Conforme a operadora responde, o status da mensagem é atualizado para **Sent**, depois **Delivered** (ou **Failed**). > **O gateway Android tem prioridade para envio.** Enquanto estiver conectado, as respostas individuais e de IA passam pelo seu telefone. Se você também tiver um número SMS da Twilio conectado, desconecte o gateway Android para enviar essas mensagens pela Twilio novamente. Uma exceção em ambos os casos: **campanhas e disparos de SMS em massa sempre passam pelo seu número Twilio**, nunca pelo telefone Android — o envio em massa a partir de um aparelho pessoal é exatamente o que faz com que números sejam sinalizados, por isso a plataforma não permite isso. --- ## Limitações O gateway Android depende de um telefone físico que você controla, portanto, ele vem com restrições que você não verá no Twilio. Analise-as antes de confiar nele para mensagens importantes. - **O telefone deve permanecer ligado e online.** Sem telefone, sem mensagens. Mantenha-o carregado, conectado ao Wi-Fi ou dados e excluído da otimização de bateria. - **Apenas baixo volume.** As operadoras sinalizam e limitam telefones que enviam muitas mensagens repentinamente. Este canal é para conversas e respostas um a um — **não para disparos em massa**. - **Disparos de SMS em massa não são suportados neste canal.** Envios de SMS em massa exigem um número Twilio conectado; a plataforma avisará se você tentar iniciar um sem o Twilio. Realize disparos através do Twilio e mantenha o gateway Android para respostas conversacionais. - **Apenas texto.** O envio e recebimento de MMS (mídia) não é suportado neste canal. - **Limites da operadora se aplicam.** A franquia de SMS do seu plano telefônico, limites de uso justo e quaisquer cobranças por mensagem são entre você e sua operadora. - **A confirmação de entrega depende da sua operadora.** Algumas operadoras relatam a entrega de forma confiável; outras não. Um status "Sent" significa que o telefone despachou o texto. - **Risco para conta/número.** Usar um número pessoal para mensagens comerciais automatizadas pode violar os termos da sua operadora e pode fazer com que o número seja limitado ou suspenso se houver abuso. Use com responsabilidade, obtenha consentimento e inclua instruções de cancelamento (opt-out). --- ## Mantendo a confiabilidade do telefone Para manter as mensagens fluindo sem interrupção: - **Desative a otimização de bateria** para o aplicativo SMS Gateway (Configurações do Android → Aplicativos → SMS Gateway → Bateria → Irrestrito). Caso contrário, o Android pode encerrá-lo em segundo plano. - **Mantenha a tela acessível / o aplicativo permitido para rodar em segundo plano.** Um telefone dedicado deixado conectado à tomada é o ideal. - **Mantenha-se em Wi-Fi ou dados estáveis.** Se o telefone perder a conectividade, os envios ficam na fila ou falham até que ele retorne. - **Mantenha o SIM ativo e em situação regular** com sua operadora. --- ## Solução de problemas ### "Não foi possível validar as credenciais do gateway" - Verifique novamente o **nome de usuário** e a **senha** na tela inicial do aplicativo de gateway — eles são regenerados se você reinstalar ou redefinir o aplicativo. - Confirme se o telefone tem internet e se o modo **Cloud Server** está ativado no aplicativo. ### O status mostra offline / as mensagens não estão sendo enviadas - Abra o aplicativo no telefone e confirme se ele está em execução e conectado ao servidor na nuvem. - Verifique se o telefone não está no modo Doze / economia de bateria e se o aplicativo está excluído da otimização de bateria. - Toque em **Refresh status** no cartão após colocar o telefone online novamente. ### Mensagens de texto recebidas não aparecem - Confirme se a conexão ainda mostra **Conectado** (toque em **Atualizar status**). - Envie uma mensagem de texto de teste para o número do telefone a partir de outro telefone. - Certifique-se de que o aplicativo de Mensagens padrão do telefone não esteja bloqueando ou filtrando o remetente. ### Uma mensagem de texto mostra "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 chip (SIM) ainda possui saldo para SMS e se o número não está suspenso. - Taxas de envio muito altas podem acionar o bloqueio da operadora; diminua a velocidade e mantenha o volume baixo. --- ## Precisa de ajuda? O gateway de SMS para Android está em **Beta**. Se você encontrar algo não coberto aqui, entre em contato com hi@youraiconnector.com com: - O número de telefone que você conectou (não a senha). - Se o aplicativo de gateway mostra que está online no telefone. - Uma descrição do problema e quando ele aconteceu. Daremos uma olhada assim que possível.