💬 Configuración SMS AI4CALL
Guía completa para integrar SMS con AI4CALL: envía confirmaciones, recordatorios y notificaciones automáticas vía SMS durante las llamadas con sistema prepago
Ve a "MARKET" → "Marketplace Plugin" y haz clic en Comprar de "SMS AI4CALL" → PAY
Ve a "MARKET" → "Mis Plugins" y haz clic en Configurar de "SMS AI4CALL"
🚀 Navegación rápida:
⚠️ Servicios de terceros
Las integraciones descritas se refieren a servicios de terceros.
Los límites de tasa, métodos de autenticación, configuraciones técnicas, costes y políticas son definidos exclusivamente por los respectivos proveedores y pueden cambiar con el tiempo.
Los costes de los servicios externos son asumidos directamente por el usuario final a los proveedores de los servicios mismos y de ninguna manera son gestionados o intermediados por nuestro portal (por ejemplo, Meta u otros proveedores para WhatsApp, Zapier, Calendly, etc.).
Qué significa:
- ❌ NO puedes personalizar alias remitente con nombre de tu empresa
- ❌ Cliente recibe SMS con remitente "AI4CALL", no "Estudio Médico" o "Agencia XYZ"
- ⚠️ Limitación técnica operador SMS - no modificable actualmente
Workaround recomendado:
- ✅ Incluye nombre empresa en el TEXTO SMS
- ✅ Ejemplo: "AI4CALL para Estudio Dental Rossi: cita confirmada martes 15 horas 10"
- ✅ Cliente entiende procedencia incluso con remitente genérico
Futuro: personalización alias custom en roadmap - contacta soporte AI4CALL para actualizaciones.
Ventajas:
- ✅ universal: funciona en TODOS móviles (incluso feature phone sin internet)
- ✅ tasa de entrega altísima: 99% entrega garantizada
- ✅ NO app requerida: llega nativamente
- ✅ latencia baja: entrega 2-30 segundos
- ✅ tasa de lectura alta: ~90% SMS leídos en 3 minutos
Desventajas:
- ⚠️ de pago: €0.035-0.05 por SMS
- ⚠️ 160 caracteres máx (texto plano, no media)
- ⚠️ NO enlaces clickables nativos (solo en smartphones modernos)
- ⚠️ remitente fijo "AI4CALL" actualmente
Cuándo usar SMS:
→ notificaciones críticas urgentes (OTP, alertas seguridad)
→ clientes sin smartphone/WhatsApp
→ backup fallback si WhatsApp/Email fallan
→ confirmaciones donde entrega garantizada es crítica
→ target demográfico senior (prefieren SMS)
Cuándo NO usar SMS:
→ mensajes largos >160 char (usa Email)
→ contenidos con media/imágenes (usa WhatsApp)
→ enlaces importantes para hacer clic (usa Email/WhatsApp)
→ volúmenes altísimos diarios (costos excesivos)
Qué es la integración SMS y cómo funciona
La integración SMS permite al asistente AI4CALL enviar mensajes de texto a teléfonos móviles durante o después de las llamadas a través de red de operadores móviles.
→ compras crédito SMS anticipadamente (100, 500, 1000 SMS)
→ cada envío decrementa contador automáticamente
→ cuando se acaban: debes comprar nuevo paquete
→ SMS prepagados NO caducan nunca
Envío one-way (solo salida):
→ asistente puede ENVIAR SMS a clientes
→ clientes NO pueden responder (número no bidireccional)
→ ideal para: confirmaciones, recordatorios, notificaciones, alertas
Remitente fijo "AI4CALL":
→ todos SMS muestran remitente "AI4CALL"
→ NO personalizable con nombre empresa actualmente
→ workaround: incluye nombre empresa en el texto del mensaje
Entrega garantizada:
→ entrega vía red operadores móviles (Vodafone, TIM, Wind, etc.)
→ 99% tasa de entrega
→ latencia 2-30 segundos típicamente
[Cliente llama estudio para reservar]
↓
[Asistente AI4CALL gestiona reserva]
↓
[Recoge: nombre, número móvil, fecha/hora cita]
↓
[Fin llamada]
↓
[AI invoca: send_sms]
↓
[Parámetros:
- dst: número móvil cliente
- txt: "AI4CALL para Estudio Dr. Rossi: cita
confirmada martes 15 marzo horas 10:00.
Via Roma 1, Milán"]
↓
[Sistema envía SMS vía operador móvil]
↓
[Cliente recibe SMS en 30 segundos]
↓
[Contador SMS disponibles decrementa: 90 → 89]
Ventaja: confirmación inmediata en dispositivo que cliente siempre lleva consigo (móvil). Funciona también sin smartphone/internet.
Paquete Base: 100 SMS a €5.00
→ costo por SMS: €0.05
→ ideal para: test, uso ocasional estudio individual
Paquete Standard: 500 SMS a €20.00
→ costo por SMS: €0.04
→ ideal para: uso medio, campañas pequeñas/medias
Paquete Premium: 1000 SMS a €35.00
→ costo por SMS: €0.035
→ ideal para: uso intensivo, volúmenes altos
Atención mensajes largos: si texto SMS >160 caracteres, divide en múltiples SMS debitados separadamente
→ 161-320 char = 2 SMS debitados
→ 321-480 char = 3 SMS debitados
Best practice: mantén bajo 160 caracteres para maximizar eficiencia
Compra paquete SMS prepago
Antes de poder enviar SMS debes comprar crédito a través de uno de los paquetes prepagados disponibles.
- Selecciona "SMS AI4CALL" de la lista de tus Plugins
- Sección "SMS Disponibles":
→ muestra contador SMS restantes (ej. "90")
→ si 0 o pocos: necesita recarga - Sección "Paquetes SMS Disponibles":
→ visualiza 3 cards paquetes con detalles - Elige paquete adecuado:
- Base 100 SMS €5: test o uso muy limitado
- Standard 500 SMS €20: recomendado para inicio (mejor relación calidad/precio)
- Premium 1000 SMS €35: volúmenes altos (>30 SMS/día)
- Haz clic botón "COMPRAR" en el paquete elegido
- Sistema redirige a checkout pago seguro
- Completa pago (tarjeta crédito/PayPal/transferencia)
- Después pago confirmado:
→ SMS añadidos automáticamente a saldo
→ contador "SMS Disponibles" actualizado
→ compra aparece en "Historial Compras" - Haz clic "ACTUALIZAR SMS RESTANTES" si contador no se actualiza automáticamente
- ✅ SMS Disponibles: count actualizado (ej. 90 → 590 si compraste Standard)
- ✅ Historial Compras: nueva fila con fecha, SMS comprados, precio
- ✅ tool send_sms ahora funcional
Nota: SMS prepagados NO caducan nunca. Puedes comprar múltiples veces - crédito se suma.
Ejemplo: tienes 90 SMS, compras Standard 500 → total pasa a ser 590 SMS disponibles.
Fórmula: (llamadas/día × % que reciben SMS × días laborables/mes)
Ejemplo Estudio Médico:
→ 20 citas/día
→ 80% clientes reciben confirmación SMS
→ 22 días laborables/mes
→ necesidad: 20 × 0.8 × 22 = 352 SMS/mes
→ paquete recomendado: Standard 500 SMS (cubre 1+ mes)
Ejemplo Agencia Seguros:
→ 50 llamadas/día
→ 30% reciben SMS (otros prefieren email)
→ 22 días laborables/mes
→ necesidad: 50 × 0.3 × 22 = 330 SMS/mes
→ paquete recomendado: Standard 500 SMS
Consejo: empieza con Standard 500, monitoriza consumo primer mes, adapta después.
Habilita tool send_sms
Después de comprar crédito SMS, habilita el tool send_sms para permitir al asistente enviar mensajes.
- Selecciona "SMS" de la lista de tus plugins:
→ ves tool send_sms con checkbox
→ descripción: "Envía un mensaje SMS a través de BeeVoIP o alias especificado" - Selecciona checkbox ☑️ send_sms
- Parámetros tool visibles:
- alias: alias del remitente (default: ai4call) - FIJO actualmente
- dst: número de destino (obligatorio)
- txt: texto del mensaje SMS (obligatorio)
- Haz clic "GUARDAR CONFIGURACIÓN"
- ✅ ¡Tool send_sms ahora disponible para asistente!
- ✅ checkbox send_sms seleccionada
- ✅ crédito SMS disponible >0
- ✅ tool listo para uso en prompt
Test rápido: llama al asistente, pide "envíame SMS de test". Deberías recibir mensaje en 30 segundos.
→ aunque presente en configuración, NO es modificable
→ todos SMS enviados muestran remitente "AI4CALL"
→ especificar alias distinto en tool call no tiene efecto
Implicación: NO pierdas tiempo intentando personalizar alias - no funcionará.
Solución: incluye identificación empresa en el TEXTO SMS, no en el alias.
Optimiza texto SMS para máxima efectividad
SMS tiene límite 160 caracteres - cada palabra cuenta. Optimiza texto para maximizar información útil minimizando costos.
✅ Ejemplo BUENO (152 caracteres):
AI4CALL para Estudio Dr. Rossi: cita martes 15 marzo horas 10:00, Via Roma 1 Milán. Para cancelación llama 02-1234567
❌ Ejemplo MALO (187 caracteres = ¡2 SMS debitados!):
AI4CALL para Estudio Dental Dr. Rossi: estimado cliente, le confirmamos que su cita está fijada para martes 15 marzo 2025 a las horas 10:00 en nuestro estudio
Técnicas abreviación inteligentes:
- "cita" → "cita." (ahorro 10 char)
- "estimado cliente" → omite (ahorro 15 char)
- "2025" → omite año si obvio (ahorro 5 char)
- "en nuestro estudio" → dirección directa (ahorro 15 char)
- "le confirmamos que" → omite formalidades excesivas
Estructura SMS efectiva:
1. Identificación: "AI4CALL para [Nombre Empresa]:" (20-30 char)
2. Mensaje core: acción/info principal (60-80 char)
3. Detalles esenciales: fecha/hora/lugar (40-50 char)
4. Call-to-action: qué hacer si necesario (20-30 char)
AI4CALL para [Empresa]: cita. [día] [fecha] horas [hh:mm], [dirección]. Cancelación: [teléfono]
→ ejemplo: "AI4CALL para Estudio Rossi: cita. mar 15/3 horas 10:00, Via Roma 1 MI. Cancelación: 02-123456"
Template 2 - Recordatorio 24h antes (142 char):
AI4CALL para [Empresa]: RECORDATORIO cita. mañana [fecha] horas [hh:mm]. Confirma presencia: [teléfono]
Template 3 - Código OTP (89 char):
AI4CALL [Empresa]: código verificación [123456]. Válido 5 min. NO compartir
Template 4 - Notificación urgente (125 char):
AI4CALL para [Empresa]: [mensaje urgente breve]. Contáctanos: [teléfono] o [email]
EVITA emoji (¡reducen límite a 70 char!):
❌ 😀❤️✅📅 → activan encoding UCS-2, máx 70 char por SMS
✅ usa texto: "OK", "atención", "recordatorio" en su lugar
Cuidado letras acentuadas (OK pero costosas):
⚠️ á é í ó ú → soportadas pero reducen eficiencia
✅ alternativa si crítico: "e" en lugar de "é"
EVITA caracteres especiales no-standard:
❌ símbolos matemáticos ∑∏≠
❌ caracteres cirílicos/árabes/chinos (a menos destinatario soporte)
✅ stick to: letras A-Z, números 0-9, puntuación base
Instruye al asistente para workflow SMS
Configura el prompt del asistente para utilizar send_sms correctamente con fallback multi-channel y optimización costos.
"Texto SMS DEBE ser <160 caracteres. Usa template: 'AI4CALL para [Empresa]: cita. [día] [fecha] horas [hh:mm], [dirección breve]. Info: [tel]'. Abrevia inteligentemente: 'cita'→'cita.', omite formalidades inútiles. Cuenta caracteres ANTES de send_sms - si >160, acorta más."
- Llama al asistente desde tu móvil
- Simula reserva: nombre, fecha, hora
- Pide: "Envíame confirmación SMS"
- Verifica: SMS recibido en 30 segundos
- Controla dashboard: SMS disponibles decrementado
- Verifica texto: <160 char, remitente "AI4CALL", info correctas
Test 2 - Fallback multi-channel:
- Simula cliente sin WhatsApp (proporciona solo número móvil + email)
- Asistente debería intentar WhatsApp → falla
- Fallback automático a Email
- Si Email falla → SMS como último recurso
Test 3 - Gestión crédito agotado:
- Espera SMS restantes = 0 (o simula)
- Pide envío SMS
- Verifica: asistente NO comunica error
- Verifica: fallback silencioso a Email
- Cliente recibe confirmación vía Email sin problemas
🛠️ Tool send_sms
Especificaciones técnicas del tool MCP para envío SMS.
send_sms
Parámetros:
alias(string, default: "ai4call"): remitente SMS - FIJO "AI4CALL" actualmente, no personalizabledst(obligatorio, string): número destino formato internacional (ej. "+393331234567")txt(obligatorio, string): texto mensaje SMS - máx 160 caracteres recomendado
Ejemplo 1 - Confirmación cita:
send_sms(
dst="+393331234567",
txt="AI4CALL para Estudio Rossi: cita. mar 15/3 horas 10:00, Via Roma 1 MI. Cancelación: 02-123456"
)
Ejemplo 2 - Código OTP:
send_sms(
dst="+393331234567",
txt="AI4CALL Estudio Médico: código verificación 847392. Válido 5 min. NO compartir"
)
Response esperada:
- ✅ Success:
{"status": "sent", "message_id": "..."} - ❌ Error crédito:
{"error": "crédito SMS insuficiente"} - ❌ Error número:
{"error": "número destino inválido"}
Notas importantes:
- ⚠️ Remitente SIEMPRE "AI4CALL" - parámetro alias ignorado actualmente
- ⚠️ Texto >160 char → múltiples SMS debitados (2 SMS si 161-320 char, 3 SMS si 321-480 char)
- ⚠️ Caracteres emoji reducen límite a ~70 char por SMS
- ⚠️ Cada envío decrementa contador SMS disponibles
- ⚠️ Entrega típica: 2-30 segundos
❓ Preguntas frecuentes
Respuestas a las preguntas más comunes sobre la integración SMS
Sistema prepago por paquetes: compras crédito SMS anticipadamente, el asistente consume cuando envía. Paquetes disponibles: Base 100 SMS €5 (€0.05/SMS), Standard 500 SMS €20 (€0.04/SMS), Premium 1000 SMS €35 (€0.035/SMS). Dashboard muestra SMS restantes en tiempo real. Cuando se acaban: tool send_sms falla, asistente debe informar cliente y usar método alternativo (email/WhatsApp). Recarga: compra nuevo paquete, crédito se suma. Caducidad: SMS prepagados NO caducan nunca.
Actualmente NO. Alias remitente es FIJO: "AI4CALL" para todos SMS enviados a través de la plataforma. Cliente recibe SMS con remitente "AI4CALL", no nombre de tu empresa personalizado. Limitación técnica operador SMS. Futuro: posible personalización alias custom (ej. "Estudio Médico", "Agencia XYZ") - contacta soporte AI4CALL para actualizaciones roadmap. Workaround: incluye nombre empresa en el TEXTO SMS: "AI4CALL para Estudio Médico: cita confirmada..."
Límite standard: 160 caracteres por SMS individual (GSM-7 encoding). Si superas: sistema divide automáticamente en SMS múltiples concatenados (máx 153 char cada uno por overhead). Ejemplos: 161 char = 2 SMS debitados, 320 char = 3 SMS. Caracteres especiales (emoji, acentos) reducen límite a ~70 char por SMS (UCS-2 encoding). Best practice: mantén bajo 160 caracteres, evita emoji para maximizar eficiencia costos. Cuenta caracteres: AI4CALL muestra preview longitud antes envío.
Dashboard AI4CALL → Gestión Plugin SMS muestra: (1) SMS Disponibles: count tiempo real (ej. "90"), (2) Historial Compras: tabla fechas compras, SMS comprados, precio pagado, (3) botón "ACTUALIZAR SMS RESTANTES" para refresh manual. Cada send_sms tool call decrementa automáticamente contador. Para analytics detallado: export log llamadas AI4CALL, filtra por tool="send_sms", cuenta ocurrencias por período/cliente/campaña. Alertas automáticos: configura notificación cuando SMS <20 para recargar a tiempo.
Tool send_sms devuelve error. Intenta gestionar elegantemente con envío de WhatsApp, email o guardando el error y comunicando al usuario "recibirá confirmación pronto".
Sí. Los SMS pueden contener enlaces. En teléfonos más antiguos el enlace puede no ser clickable, mientras que en smartphones modernos lo es automáticamente. En cualquier caso es recomendado usar URLs cortas (short link) para ahorrar caracteres.
Tool send_sms envía INMEDIATAMENTE - NO scheduling nativo. Para envíos programados: (1) integra con n8n/Zapier que soporta delay, (2) AI guarda datos + timestamp deseado en database, (3) cron job lee database, (4) cuando timestamp llega: invoca send_sms automáticamente. Ejemplo recordatorio cita: (1) cita reservada 15 marzo, (2) guarda evento + reminder_timestamp = 14 marzo horas 10:00, (3) cron diario horas 10 controla pending reminders, (4) envía SMS "Recordatorio: cita mañana horas 15".
Casi instantáneo. Latencia típica: 2-30 segundos desde invocación send_sms a recepción cliente. Factores retardo: (1) red operador móvil destinatario (coverage area), (2) teléfono encendido/apagado (si apagado: entrega al reencendido), (3) roaming internacional (retrasos mayores), (4) congestión red (eventos masivos, Año Nuevo). Tasa entrega: 99% en 60 segundos, 99.9% en 5 minutos. Si SMS no llega: verifica número correcto formato internacional (+39...), cliente en área coverage, teléfono no bloqueado.
Por defecto NO. Contacta el soporte AI4CALL para información sobre paquetes internacionales.
NO. Sistema actual es SEND-ONLY (solo envío). Cliente NO puede responder a SMS recibidos de "AI4CALL" - número remitente no es bidireccional. Para conversaciones bidireccionales: usa WhatsApp (soporta respuestas nativas) o proporciona número telefónico empresarial en el texto SMS: "Para responder llama 02-12345678". Futuro: posible número SMS bidireccional dedicado con webhook respuestas - contacta soporte AI4CALL para roadmap. SMS ideal para: notificaciones one-way, confirmaciones, alertas, recordatorios.
Encoding GSM-7 (standard): soporta letras A-Z, números 0-9, puntuación base (. , ! ? - ( ) ), símbolos €£$@. Caracteres NO soportados/problemáticos: emoji (😀❤️ = error encoding o fallback UCS-2 costoso), letras acentuadas italianas (à è ì ò ù = OK pero reducen límite 160→70 char), caracteres cirílicos/árabes/chinos (solo si destinatario soporta). Best practice: usa solo ASCII standard, evita emoji, reemplaza "è" con "e" si posible, testea con número real antes producción.
Sí, SMS ideal para OTP (One-Time Password). Workflow seguro: (1) genera código random 6 cifras, (2) guarda en database con timestamp + user_id, (3) send_sms(text="Código verificación: 123456. Válido 5 minutos"), (4) usuario inserta código en app/web, (5) verifica match database + no caducado. Best practice OTP: (1) código numérico 6 cifras (fácil teclear), (2) caducidad 5-10 min, (3) rate limit intentos (máx 3), (4) incluye nombre servicio: "Código AI4CALL Estudio Médico: 123456", (5) invalidación post-uso.
Costo por SMS individual: €0.035-0.05 (depende de paquete comprado). Mensajes largos: si >160 char, dividido en múltiples SMS debitados separadamente. Ejemplo cálculo: mensaje 320 caracteres = 3 SMS = €0.15 total (paquete Premium €0.035×3). Optimización costos: (1) mantén bajo 160 char, (2) evita emoji (reducen a 70 char), (3) usa abreviaciones aceptables ("cita" → "cita."), (4) considera Email/WhatsApp para mensajes largos (gratuitos ilimitados). ROI: compara costo SMS vs valor cliente/conversión.
Checklist troubleshooting: (1) verifica disponibilidad de SMS-AI4CALL, (2) controla formato número: prefijo internacional +39 para Italia, no espacios/guiones, (3) texto SMS: <160 char, no caracteres inválidos, (4) Response Tool de AI4CALL: busca errores tool send_sms (crédito insuficiente u otro).