Saltar al contenido

API SMS / Telegram

Conecta proveedores SMS y Telegram para notificaciones.

7 min de lectura

Conecta el proveedor SMS o Telegram que usará el sistema para avisos y envíos masivos.

Antes de empezar:

  • Permiso settings_access.
  • Cuenta con saldo/créditos (SMS) o bot creado en @BotFather (Telegram).
  • WhatsApp no se configura aquí: va en WhatsApp AI.

1. Abrir el módulo

  1. Menú Ajustes → Integraciones → API SMS / Telegram.
  2. Entras a /messaging-api-settings.

Vista: API SMS / Telegram

Verás:

  • KPIs: Proveedores, Activos, Canales SMS, Telegram.
  • Tarjetas de recomendación (SMS económico Plivo, enterprise Vonage, Telegram).
  • Panel Guía de configuración (pestañas Plivo / Twilio / Vonage / Telegram).
  • Formulario Agregar proveedor y tabla Proveedores configurados.

2. Elegir y guardar un proveedor

En Agregar proveedor:

Campo UI Obligatorio Según proveedor
Tipo de proveedor Sí Plivo, Twilio, Vonage, Telegram Bot
Estado Sí Activo / Inactivo
Auth ID / Account SID / API Key / Bot Token Sí Etiqueta cambia con el tipo
Auth Token / API Secret Sí (SMS) En Telegram suele no usarse
Número remitente / From / Chat ID Sí (SMS) E.164 (+1809…); Telegram: chat_id opcional
Límite caracteres No Default 480
Pausa (seg) No Default 3 entre envíos

Pasos:

  1. Elige Tipo de proveedor.
  2. Sigue la guía lateral (máx. 5 pasos del proveedor).
  3. Pega credenciales reales.
  4. Estado: Activo si será el canal de salida.
  5. Guardar proveedor.

Importante: Solo puede haber un SMS activo (Plivo, Twilio o Vonage). Si otro ya está activo, guarda el nuevo como Inactivo o desactiva el anterior. Telegram puede coexistir.

3. Credenciales por proveedor

Plivo (SMS económico)

  1. Consola Plivo → Auth ID + Auth Token.
  2. Número SMS en formato E.164.
  3. En el form: Auth ID, Auth Token, Número remitente.

Twilio

  1. Console → Account SID + Auth Token.
  2. From number de Twilio.
  3. Etiquetas UI: Account SID, Auth Token, Número remitente.

Vonage

  1. Dashboard → API Key + API Secret.
  2. From (número o sender ID permitido).
  3. UI: API Key como cuenta, Secret como token.

Telegram Bot

  1. @BotFather → /newbot → copia el token.
  2. Pégalo en Bot Token.
  3. El destinatario real es el chat_id numérico (el cliente debe haber escrito al bot).
  4. Opcional: chat_id de prueba en el campo remitente.

4. Probar, editar o eliminar

En Proveedores configurados (columnas ID, Proveedor, Tipo, Remitente, Estado, Acciones):

  1. Icono avión (Probar): envía un mensaje de prueba al móvil o chat_id.
  2. Lápiz: edita y vuelve a Guardar proveedor (o Cancelar).
  3. Basura: elimina el registro.

También puedes usar el botón superior Probar conexión (lleva a la tabla de proveedores).

5. Dónde se usa

  • Avisos / notificaciones a clientes.
  • Mensajería → SMS Enviado (/messaging/sent-messages) para historial y Envío masivo.
  • WhatsApp sigue en /whatsapp-ai.

6. Checklist

  1. Proveedor guardado en la tabla
  2. Un solo SMS en estado Activo (si usas SMS)
  3. Probar recibido en tu móvil / Telegram
  4. Saldo o bot listo antes de envíos masivos
  5. Límite de caracteres acorde al canal