API de Mensajería de Aircall

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 optimizar flujos de trabajo relacionados con la mensajería SMS y MMS.

Importante: El envío de mensajes mediante API solo está disponible en el Plan Professional de Aircall. Para actualizarlo, ponte en contacto con nuestro equipo de Éxito del cliente.

Este artículo 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 aplicable.

Descripción general 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 normativo. 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.

Seleccionar el endpoint adecuado

Antes de seleccionar un endpoint, ten en cuenta lo siguiente:

• La mensajería por API solo está disponible para números de Aircall que tengan SMS habilitado.
• Los números de Aircall con mensajería por API pueden seguir utilizándose 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 podrá enviar ni recibir mensajes desde la aplicación de Aircall. Para restaurar la mensajería en las aplicaciones de Aircall, debe eliminarse 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 Primeros pasos para enviar mensajes omitiendo la bandeja de entrada de Aircall con 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 posibilidad 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 un mensaje 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 Primeros pasos con el endpoint ‘Enviar mensaje en la conversación del Agente’ en la API de Aircall.

Funciones y normativas de la mensajería API de Aircall

Independientemente del endpoint que uses, la mensajería mediante API debe seguir los estándares del sector y las normativas locales.

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 solo agente que controle su uso.
• Verifica siempre el cumplimiento de la normativa local antes de implementar mensajería automatizada.

Importante: Busca asesoramiento jurídico 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 números long code de EE. UU. y los números gratuitos de EE. UU./CA deben estar completamente registrados antes de su uso.
• 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 60 por minuto para todos los endpoints. Se aplican límites adicionales por hora, por día y por mes según el tipo de número y el país.

Nota: La tasa límite está sujeta a cambios sin previo aviso para garantizar un uso adecuado.

Precios

El acceso a la API Send Message está incluido en el Plan Professional. El volumen de mensajes tanto de 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 tu plan o saber más, ponte en contacto con nuestro equipo de Éxito del cliente.

Para continuar con la configuración:

• Para la Opción 1, consulta Primeros pasos para enviar mensajes omitiendo la bandeja de entrada de Aircall con la API de Aircall.
• Para la Opción 2, consulta Primeros pasos con el endpoint ‘Enviar mensaje en la conversación del Agente’ en la API de Aircall.