API de mensajería de Aircall

La API de mensajes de Aircall forma parte del kit de herramientas para desarrolladores de Aircall, que permite a aplicaciones y servicios externos interactuar programáticamente 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: E:
El envío de mensajes a través de la API solo está disponible en el plan Profesional de Aircall. Para actualizar, por favor contacte con nuestro equipo de Customer Success.

Este artículo explica cómo usar la API de mensajes de Aircall, seleccionar el endpoint correcto según sus necesidades y cumplir con las normativas relevantes de mensajería.

Visión general de la API de mensajes

La API de mensajes de Aircall permite a los administradores recuperar la actividad de mensajes, enviar mensajes SMS y MMS, y garantizar el cumplimiento normativo. Al enviar mensajes, puede elegir entre dos endpoints distintos:

• Opción 1: Enviar mensaje
• Opción 2: Enviar mensaje en conversación de agente

Cada uno funciona de manera diferente, y no es posible usar ambos endpoints en el mismo número de Aircall simultáneamente.

Selección del endpoint adecuado

Antes de seleccionar un endpoint, tenga en cuenta:

• La mensajería por API solo está disponible para números de Aircall habilitados para SMS.
• Los números de Aircall con mensajería por API pueden seguir usándose para llamadas entrantes y salientes en las aplicaciones de Aircall.

Opción 1: Endpoint Enviar mensaje

Usar el endpoint Enviar mensaje 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 webhooks. Los mensajes son completamente externos, por lo que su 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.
• Se admite MMS.
• 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, debe eliminarse la configuración.

Ejemplos de casos de uso:

• Integrar Aircall con una herramienta externa donde los usuarios puedan ver y responder mensajes directamente.
• Enviar códigos de verificación únicos o mensajes automatizados (por ejemplo, confirmaciones de pedido, actualizaciones de entrega).
• Enviar mensajes de marketing o promocionales no conversacionales.

Para detalles de implementación, consulte Primeros pasos para enviar mensajes usando la API de Aircall.

Opción 2: Endpoint Enviar mensaje en conversación de agente

Usar el endpoint Enviar mensaje en conversación de agente permite que los mensajes enviados vía 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:

• No se admite MMS vía API.
• 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:

• Saludar automáticamente a los clientes que envían mensajes a su número de Aircall, informándoles que un agente responderá en breve.
• Enviar mensajes automatizados desencadenados por eventos del CRM (por ejemplo, cuando un cliente alcanza una etapa específica). Cualquier respuesta del cliente aparece en Aircall, permitiendo que los agentes continúen la conversación sin interrupciones.

Para instrucciones de configuración, consulte Primeros pasos con el endpoint ‘Enviar mensaje en conversación de agente’ en la API de Aircall.

Características y normativas de la mensajería API de Aircall

Independientemente del endpoint que utilice, la mensajería vía API debe cumplir con estándares industriales y regulaciones locales.

Estados Unidos y Canadá

• Los SMS automatizados y de marketing están permitidos si su número está debidamente registrado (consulte registro A2P 10DLC y directrices para números gratuitos) y puede demostrar el consentimiento del cliente.

Francia

• Las líneas móviles son solo para uso personal y conversacional. Está prohibido el envío de SMS automatizados o masivos vía API, pero se permite la mensajería conversacional.

Guía general

• Las líneas móviles deben estar asignadas a un solo agente que controle su uso.
• Verifique siempre el cumplimiento con las regulaciones locales antes de implementar mensajería automatizada.

Importante: E:
Consulte con asesoría legal local para garantizar que su caso de uso de mensajería cumpla con la normativa.

Consideraciones al usar la API de mensajes

Requisitos regulatorios

• Los códigos largos de EE. UU. y los números gratuitos de EE. UU. y Canadá 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).

Límites de tasa

Aircall limita las solicitudes API a 60 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 país.

NOTA:
Los límites de tasa pueden cambiar sin previo aviso para garantizar un uso adecuado.

Precios

El acceso a la API de envío de mensajes está incluido en el plan Profesional. El volumen de mensajes tanto de la API como de las aplicaciones se combina en su factura, y las tarifas por mensaje son idénticas a las que se aplican a través de las aplicaciones de Aircall.

Para actualizar o saber más, por favor contacte con nuestro equipo de Customer Success.

Para continuar con su configuración:

• Para la Opción 1, consulte Primeros pasos para enviar mensajes usando la API de Aircall.
• Para la Opción 2, consulte Primeros pasos con el endpoint ‘Enviar mensaje en conversación de agente’ en la API de Aircall.