La API de mensajes de Aircall forma parte del conjunto de herramientas para desarrolladores de Aircall, lo que permite que aplicaciones y servicios externos interactúen mediante programación con las capacidades de mensajería de Aircall. Ayuda a las empresas a automatizar procesos, crear integraciones y agilizar flujos de trabajo relacionados con los mensajes SMS y MMS.
IMPORTANTE: El envío de mensajes mediante API solo está disponible en el Plan Professional de Aircall. Para actualizar, ponte en contacto con nuestro equipo de Éxito del cliente.
En este artículo se explica cómo usar la API de mensajes de Aircall, seleccionar el endpoint correcto según tus necesidades y cumplir con la normativa de mensajería pertinente.
Resumen de la API de mensajes
La API de mensajes de Aircall permite a los administradores recuperar la actividad de los mensajes, enviar mensajes SMS y MMS, y garantizar el cumplimiento. Al enviar mensajes, puedes elegir entre dos endpoints distintos:
- Opción 1: Enviar mensaje omitiendo la bandeja de entrada de Aircall
- Opción 2: Enviar mensaje en la conversación del Agente
Cada uno funciona de forma diferente, y no es posible usar ambos endpoints en el mismo número de Aircall al mismo tiempo.
Selección del endpoint adecuado
Antes de seleccionar un endpoint, ten en cuenta lo siguiente:
- La Mensajería por API solo está disponible para los números de Aircall que tienen SMS habilitado.
- Los números de Aircall con Mensajería por API aún pueden usarse para llamadas entrantes y salientes en las aplicaciones de Aircall.
Opción 1: endpoint Enviar mensaje omitiendo la bandeja de entrada de Aircall
Usar el endpoint Enviar mensaje omitiendo la bandeja de entrada de Aircall permite que un número de Aircall envíe y reciba mensajes SMS o MMS que no se muestran en las aplicaciones de Aircall ni se incluyen en los webhooks. Los mensajes son completamente externos, por lo que tu sistema debe registrarlos en otro lugar.
Detalles clave:
- Los SMS/MMS enviados y recibidos no aparecen en los webhooks ni en las aplicaciones de Aircall.
- MMS es compatible.
- Una vez configurado con este endpoint, el número no puede enviar ni recibir mensajes desde la aplicación de Aircall. Para restaurar la mensajería en las aplicaciones de Aircall, se debe eliminar la configuración.
Ejemplos de casos de uso:
- Integra Aircall con una herramienta externa donde los usuarios puedan ver y responder mensajes directamente.
- Envía códigos de verificación de un solo uso o mensajes automatizados (por ejemplo, confirmaciones de pedido, actualizaciones de entrega).
- Envía mensajes de marketing o promocionales no conversacionales.
Para ver los detalles de implementación, consulta Introducción al envío de mensajes omitiendo la bandeja de entrada de Aircall mediante la API de Aircall.
Opción 2: endpoint Enviar mensaje en la conversación del Agente
Usar el endpoint Enviar mensaje en la conversación del Agente permite que los mensajes enviados mediante API aparezcan directamente en las aplicaciones de Aircall. A diferencia de la Opción 1, esta configuración mantiene la visibilidad para los usuarios y permite conversaciones continuas.
Detalles clave:
- MMS mediante API no es compatible.
- Los SMS enviados y recibidos aparecen en las aplicaciones de Aircall y en los webhooks de eventos de mensajes.
- Combina la automatización con la capacidad de que los usuarios de Aircall continúen la conversación dentro de la aplicación.
Ejemplos de casos de uso:
- Saluda automáticamente a los clientes que envían mensajes de texto a tu número de Aircall, informándoles de que un Agente responderá en breve.
- Envía mensajes automatizados activados por eventos del CRM (por ejemplo, cuando un cliente alcanza una etapa específica). Cualquier respuesta del cliente aparece en Aircall, lo que permite a los agentes continuar la conversación sin interrupciones.
Para ver las instrucciones de configuración, consulta Introducción al endpoint ‘Enviar mensaje en la conversación del Agente’ en la API de Aircall.
Funciones y normativa de la mensajería de la API de Aircall
Independientemente del endpoint que uses, la mensajería mediante API debe seguir los estándares del sector y la normativa local.
Estados Unidos y Canadá
- Los SMS automatizados y de marketing están permitidos si tu número está debidamente registrado (consulta el registro A2P 10DLC y las directrices para números gratuitos) y puedes demostrar el consentimiento del cliente.
Francia
- Las líneas móviles son solo para uso personal y conversacional. Los SMS automatizados o masivos mediante API están prohibidos, pero la mensajería conversacional sigue estando permitida.
Orientación general
- Las líneas móviles deben estar asignadas a un único agente que controle su uso.
- Verifica siempre el cumplimiento de la normativa local antes de implementar mensajería automatizada.
IMPORTANTE: Busca orientación legal local para asegurarte de que tu caso de uso de mensajería cumple con la normativa.
Consideraciones al usar la API de mensajes
Requisitos normativos
- Los códigos largos de EE. UU. y los números gratuitos de EE. UU./CA deben estar completamente registrados antes de usarse.
- Solo se admite la mensajería nacional, excepto entre EE. UU. y Canadá (igual que la mensajería desde las aplicaciones de Aircall).
Tasa límite
Aircall limita las solicitudes de API a 120 por minuto para todos los endpoints. Se aplican límites adicionales por hora, día y mes según el tipo de número y el país.
| Tipo de número | Límite por hora | Límite diario | Límite mensual |
|---|---|---|---|
| Números de EE. UU. y CA | 1,000 | 10,000 | 20,000 |
| Líneas móviles francesas | 100 | 1,000 | 10,000 |
| Otras líneas | 500 | 2,000 | 20,000 |
NOTA: La tasa límite está sujeta a cambios sin previo aviso para garantizar un uso adecuado.
Precios
El acceso a la API de envío de mensajes está incluido en el Plan Professional. El volumen de mensajes procedente tanto de la API como de la aplicación se combina en tu factura, y las tarifas por mensaje son idénticas a las generadas a través de las aplicaciones de Aircall.
Para actualizar u obtener más información, ponte en contacto con nuestro equipo de Éxito del cliente.
Para continuar con la configuración:
- Para la Opción 1, consulta Introducción al envío de mensajes omitiendo la bandeja de entrada de Aircall mediante la API de Aircall.
- Para la Opción 2, consulta Introducción al endpoint ‘Enviar mensaje en la conversación del Agente’ en la API de Aircall.