Una sola API REST para mensajería, voz, numeración, eSIM y CRM. Webhooks firmados, sandbox al aprobarse tu acceso, y versionado estable. Lo que ves en el portal, existe en la API.
Autenticación Bearer sobre HTTPS. Recursos REST predecibles bajo api.airtimeconnect.ai, con respuestas JSON y errores consistentes.
Conversaciones, mensajes, inboxes, contactos, campañas y plantillas en todos los canales conectados.
Leads, contactos, empresas, negocios, actividades, tareas y workflows de Airtime CRM.
Voice bots, agentes TTS/STT y registros de llamadas sobre Airtime PBX.
Búsqueda, reserva, provisión y port-in de números DID con MNP nativa.
Emisión de perfiles, planes y ciclo de vida de líneas móviles para resellers y MVNOs.
Tenants, roles, invitaciones y módulos: administra tu cuenta (o las de tus clientes) por API.
Con tu API key de sandbox, el primer mensaje sale en minutos. El mismo endpoint sirve para SMS, Instagram, Messenger y Telegram cambiando el canal del inbox.
Aprobada tu cuenta, generas una API key desde el portal.
WhatsApp Business se registra con un asistente guiado; el inbox queda disponible por API.
POST para enviar, webhook firmado para recibir estados y mensajes entrantes.
# 1 · Enviar un mensaje en una conversación curl -X POST https://api.airtimeconnect.ai/api/messaging/v1/conversations/{id}/messages \ -H "Authorization: Bearer $AIRTIME_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "content": "Tu código de verificación es 84921" }' # ← 201 { "id": "msg_9f2ke1", "status": "submitted", "channel": "whatsapp" }
# Evento entrante en tu endpoint (firmado) POST https://tu-app.com/events X-Airtime-Signature: t=1720650000,v1=5f8a… { "type": "message.delivered", "data": { "message_id": "msg_9f2ke1", "delivered_at": "2026-07-10T14:32:08Z" } } # Reintentos con backoff exponencial hasta confirmar 2xx
Cada evento llega firmado con HMAC para que verifiques su origen. Si tu endpoint no responde, reintentamos con backoff exponencial y te mostramos el historial de entregas en el portal.
Los canales sociales se registran con flujos guiados desde el portal; SMS y voz salen por nuestra propia red de operador, sin agregadores.
| Canal | Alta | Envío | Recepción |
|---|---|---|---|
| WhatsApp Business | Asistente guiado en el portal | ✓ API | ✓ Webhook |
| Instagram Direct | Conexión de cuenta business | ✓ API | ✓ Webhook |
| Facebook Messenger | Conexión de página | ✓ API | ✓ Webhook |
| Telegram | Registro de bot por API | ✓ API | ✓ Webhook |
| SMS (red propia) | Número DID provisionado por API | ✓ API | ✓ Webhook |
| Voz (red propia) | Número DID / troncal SIP | ✓ API / SIP | ✓ Webhook / SIP |
Crea un lead cuando entra una conversación, provisiona un número cuando cierras un cliente. Todo con el mismo token y las mismas convenciones.
# Crear un lead en Airtime CRM curl -X POST https://api.airtimeconnect.ai/api/crm/v1/leads \ -H "Authorization: Bearer $AIRTIME_API_KEY" \ -d '{ "name": "Empresa Andina SpA", "source": "whatsapp" }' # Buscar números disponibles en Santiago curl "https://api.airtimeconnect.ai/api/numbering/v1/numbers?country=CL&area=santiago" \ -H "Authorization: Bearer $AIRTIME_API_KEY"
Solicita acceso con el plan Individual: es gratuito, incluye keys y números de prueba, y tu configuración se conserva al pasar a producción.