# Teléfono Android como pasarela SMS (Beta) Utilice su propio teléfono Android como emisor de SMS. En lugar de conectar una cuenta de Twilio, instale una pequeña aplicación de código abierto en un teléfono Android, vincúlela con su espacio de trabajo y sus mensajes de texto se enviarán y recibirán a través del número y el plan de telefonía de dicho dispositivo. > **Canal beta.** La pasarela de SMS para Android ya está disponible para todos los usuarios con un plan que incluya asignación de canales, pero sigue siendo una novedad; es posible que encuentre algún detalle por pulir y tenga en cuenta que el comportamiento y los límites pueden cambiar a medida que el canal madure. Si algo no funciona como se describe, informe al equipo de soporte. --- ## Por qué utilizar esto La pasarela de Android está diseñada para **SMS conversacionales de bajo volumen**: responder a clientes potenciales, conversaciones con IA y mensajes de texto uno a uno. Es una buena opción cuando: - Desea seguir enviando mensajes de texto desde su **número personal o comercial existente**. - Twilio resulta **excesivo o tiene un precio poco adecuado** para su país o volumen de mensajes. - Prefiere utilizar la **tarifa de SMS existente de su operador** en lugar de pagar tarifas por mensaje. - Desea **evitar el papeleo de registro del operador** (A2P 10DLC y similares) que exige Twilio. No está diseñada para envíos masivos — consulte las [Limitaciones](#limitations) a continuación. > **Prefiera Twilio para mayor escala y fiabilidad.** Si envía mensajes en volumen, necesita un tiempo de actividad garantizado o realiza envíos masivos de SMS, conecte un número de Twilio en su lugar — consulte [Mensajería SMS](sms.md). Ambos son transportes de SMS alternativos; los mensajes, contactos, la IA y su bandeja de entrada funcionan igual de cualquier manera. --- ## Lo que necesitas - **Un teléfono Android** con una tarjeta SIM activa y un plan de SMS (se recomienda encarecidamente un plan de SMS ilimitado o generoso). - **La aplicación gratuita y de código abierto "SMS Gateway for Android"** de [sms-gate.app](https://sms-gate.app): descárguela desde el sitio o desde sus [lanzamientos de GitHub](https://github.com/capcom6/android-sms-gateway/releases/latest). Nosotros no creamos esta aplicación; es un proyecto de terceros. - **El teléfono debe mantenerse encendido, conectado y sin restricciones**: consulte [Cómo mantener el teléfono fiable](#keeping-the-phone-reliable). - **Un plan de pago**: la pasarela de Android está incluida en su asignación de canales. No hay **tarifa de plataforma por mensaje** ni factura de Twilio; usted utiliza el plan de operador de su propio teléfono. Si la IA genera una respuesta, esa respuesta sigue utilizando créditos de IA, igual que en cualquier otro canal. --- ## Configuración de la aplicación de pasarela 1. Instale **SMS Gateway for Android** desde [sms-gate.app](https://sms-gate.app) en el teléfono cuyo número desea utilizar. 2. Abra la aplicación. 3. Active el modo **Cloud Server** (la opción más sencilla: se retransmite a través del servidor alojado del proyecto para que su teléfono no necesite una dirección pública). 4. La aplicación genera un **nombre de usuario** y una **contraseña** en la pantalla de inicio. Los pegará en la plataforma en la siguiente sección. 5. (Recomendado) En la aplicación, abra **Settings → Webhooks**. Un webhook es una notificación automática que la aplicación envía a la plataforma cada vez que ocurre algo; en este caso, cada vez que llega un mensaje. 6. Copie la **Signing Key**. Pegarla en la plataforma añade una comprobación de firma adicional en los mensajes entrantes. > **Modo local (avanzado).** Si prefiere que el teléfono se comunique directamente con la plataforma a través de su propia red en lugar de utilizar la retransmisión en la nube, la aplicación también admite el modo Local Server. Deberá exponer el teléfono en una dirección HTTPS accesible e introducir esa dirección como URL base al realizar la conexión. El modo en la nube es el recomendado para casi todos los usuarios. --- ## Conexión del teléfono a la plataforma 1. En la barra lateral izquierda, haz clic en **Settings** cerca de la parte inferior. 2. En el panel izquierdo de Settings, bajo **Channels**, haz clic en **Channels**. 3. Busca la tarjeta **Android SMS Gateway** y haz clic en **Connect**. 4. Introduce el **Phone number**: el número propio del teléfono en formato internacional (E.164), p. ej., `+14155551234`. 5. Introduce el **Gateway username** y la **Gateway password** desde la pantalla de inicio de la aplicación de la pasarela. 6. Opcionalmente, pega la **Webhook signing key** (recomendado) desde la configuración de Webhooks de la aplicación. 7. Haz clic en **Connect**. La plataforma valida las credenciales, registra los webhooks de mensaje y entrega en la pasarela por ti, y cambia el estado a **Conectado**. No es necesario copiar y pegar URLs de webhook en la aplicación: el registro es automático. ### Comprobación del estado Una vez conectado, el botón de la tarjeta cambia de **Connect** a **Manage**. Haz clic en él para volver a abrir el panel de la pasarela, donde encontrarás **Refresh status** en cualquier momento. Esto vuelve a comprobar si la pasarela es accesible y muestra si el teléfono está actualmente **online**. Si el teléfono está en reposo o desconectado, verás un indicador claro de desconexión para que sepas que los mensajes no se enviarán hasta que vuelva a estar disponible. ### Desconexión Haz clic en **Manage** en la tarjeta para volver a abrir el panel de la pasarela y, a continuación, haz clic en **Disconnect**. La plataforma elimina los webhooks que registró en la pasarela y borra la conexión. Tus mensajes volverán a enviarse a través de Twilio si tienes un número SMS de Twilio conectado, o los SMS se desactivarán si no lo tienes. --- ## Cómo fluyen los mensajes ### Entrantes 1. Alguien envía un mensaje de texto al número de su teléfono. 2. La aplicación de la pasarela en el teléfono detecta el SMS y notifica a la plataforma. 3. La plataforma crea un contacto (si es nuevo), coloca el mensaje en su bandeja de entrada y, si el agente de IA relevante está activo, responde. ### Salientes 1. Usted o la IA envían una respuesta desde la plataforma. 2. La plataforma entrega el mensaje a su pasarela. 3. El teléfono lo envía como un SMS normal desde su número, a través de su operador. 4. A medida que el operador informa, el estado del mensaje se actualiza a **Sent**, luego a **Delivered** (o **Failed**). > **La pasarela de Android tiene prioridad para el envío.** Mientras esté conectada, las respuestas individuales y de IA se realizarán a través de su teléfono. Si también tiene conectado un número SMS de Twilio, desconecte la pasarela de Android para volver a enviar esos mensajes a través de Twilio. Una excepción en ambos casos: **los envíos masivos de SMS de campañas y difusión siempre se realizan a través de su número de Twilio**, nunca a través del teléfono Android; el envío masivo desde un dispositivo personal es exactamente lo que provoca que los números sean marcados como spam, por lo que la plataforma no lo permite. --- ## Limitaciones La pasarela de Android depende de un teléfono físico que tú controlas, por lo que conlleva limitaciones que no verás en Twilio. Revísalas antes de confiar en ella para mensajes importantes. - **El teléfono debe permanecer encendido y conectado.** Sin teléfono, no hay mensajes. Manténgalo cargado, conectado a Wi-Fi o datos, y excluido de la optimización de batería. - **Solo bajo volumen.** Los operadores marcan y limitan los teléfonos que envían repentinamente muchos mensajes de texto. Este canal es para conversaciones y respuestas uno a uno; **no para envíos masivos**. - **Los envíos masivos de SMS no son compatibles en este canal.** Los envíos masivos de SMS requieren un número de Twilio conectado; la plataforma se lo indicará si intenta lanzar uno sin Twilio. Realice los envíos a través de Twilio y mantenga la pasarela de Android para respuestas conversacionales. - **Solo texto.** El envío y recepción de MMS (medios) no es compatible en este canal. - **Se aplican los límites del operador.** La asignación de SMS de su plan telefónico, los límites de uso justo y cualquier cargo por mensaje son entre usted y su operador. - **La confirmación de entrega depende de su operador.** Algunos operadores informan de la entrega de forma fiable; otros no. Un estado "Sent" significa que el teléfono envió el mensaje de texto. - **Riesgo de cuenta/número.** El uso de un número personal para mensajes de texto comerciales automatizados puede violar los términos de su operador y puede hacer que el número sea limitado o suspendido si se abusa de él. Úselo de forma responsable, obtenga consentimiento e incluya instrucciones para darse de baja. --- ## Mantener la fiabilidad del teléfono Para mantener los mensajes fluyendo sin interrupciones: - **Desactiva la optimización de batería** para la aplicación SMS Gateway (Ajustes de Android → Aplicaciones → SMS Gateway → Batería → Sin restricciones). De lo contrario, Android podría cerrarla en segundo plano. - **Mantén la pantalla accesible / permite que la aplicación se ejecute en segundo plano.** Un teléfono dedicado y siempre enchufado es lo ideal. - **Mantente en una red Wi-Fi o de datos estable.** Si el teléfono pierde la conectividad, los envíos se ponen en cola o fallan hasta que se restablezca. - **Mantén la tarjeta SIM activa y en buen estado** con tu operador. --- ## Solución de problemas ### "No se pudieron validar las credenciales de la pasarela" - Vuelve a comprobar el **nombre de usuario** y la **contraseña** en la pantalla de inicio de la aplicación de la pasarela; se regeneran si reinstalas o restableces la aplicación. - Confirma que el teléfono tiene internet y que el modo **Servidor en la nube** está activado en la aplicación. ### El estado aparece como desconectado / los mensajes no se envían - Abra la aplicación en el teléfono y confirme que se está ejecutando y que muestra que está conectada al servidor en la nube. - Compruebe que el teléfono no esté en modo Doze/ahorro de batería y que la aplicación esté excluida de la optimización de batería. - Toque **Refresh status** en la tarjeta después de volver a conectar el teléfono. ### Los mensajes de texto entrantes no aparecen - Confirma que la conexión sigue mostrando **Conectado** (toca **Actualizar estado**). - Envía un mensaje de texto de prueba al número del teléfono desde otro teléfono. - Asegúrate de que la aplicación de Mensajes predeterminada del teléfono no esté bloqueando o filtrando al remitente. ### Un mensaje de texto muestra "Error" - El operador lo rechazó: comprueba que el número del destinatario sea válido y esté en formato internacional. - Confirma que tu tarjeta SIM aún tiene saldo para SMS y que el número no está suspendido. - Las tasas de envío muy altas pueden activar la limitación del operador; reduce la velocidad y mantén un volumen bajo. --- ## ¿Necesita ayuda? La pasarela de SMS de Android está en **Beta**. Si encuentras algo que no se cubra aquí, contacta a hi@youraiconnector.com con: - El número de teléfono que conectaste (no la contraseña). - Si la aplicación de la pasarela muestra que está en línea en el teléfono. - Una descripción del problema y cuándo ocurrió. Le echaremos un vistazo tan pronto como podamos.