Acerca de la API de mensajería de Aircall

Introducción

La API de mensajes de Aircall es parte del conjunto de herramientas para desarrolladores de Aircall que permiten que las aplicaciones y los servicios externos interactúen de manera programática con las capacidades de mensajería de Aircall. Esto brinda a las empresas la capacidad de crear automatizaciones, integraciones y optimizar los flujos de trabajo relacionados con SMS y MMS.

Este artículo cubre:

• Descripción general de la API de mensajería
  • Seleccionar el punto final adecuado para sus necesidades
    • Opción 1: 'Enviar mensaje'
    • Opción 2: 'Enviar mensaje en la conversación del agente'
  • Ejemplos de casos de uso
• Consideraciones al utilizar la API para el envío de SMS
  • Orientación general sobre las normas de Aircall
  • Especificaciones de límite de velocidad
• Detalles de precios

Descripción general de la API de mensajería

A través de esta API pública, los administradores pueden recuperar la actividad de mensajería, enviar mensajes y garantizar el cumplimiento, entre otras funciones. Cuando se trata de enviar mensajes, puede aprovechar la API de mensajería con dos puntos finales claramente diferentes . Con las descripciones y los ejemplos a continuación, es importante seleccionar la opción de punto final que se ajuste a sus necesidades (ya que se comportan de manera diferente).

No es posible utilizar ambas opciones de punto final en el mismo número de Aircall simultáneamente.

Selección del punto final adecuado para sus necesidades

Antes de seleccionar una opción, tenga en cuenta lo siguiente:

• La mensajería API solo es posible para los números de Aircall que estén habilitados para SMS
• Los números de Aircall con mensajería API aún se pueden usar para llamadas entrantes & salientes en las aplicaciones de Aircall.

Opción 1: Punto final 'Enviar mensaje'

Al utilizar el punto de conexión Enviar mensaje con un de Aircall, los SMS/MMS enviados & recibidos no pueden en las aplicaciones o webhooks de Aircall. Esto que los mensajes enviados & recibidos serán visibles los usuarios directamente en Aircall. Por lo tanto, con esta opción, es responsabilidad del cliente registrar los mensajes enviados & recibidos en una ubicación externa de su elección.

❌ Los SMS/MMS enviados & recibidos no aparecerán en los webhooks de Aircall

✅ MMS es compatible con esta opción

⚠️ Una vez que se configura un número con este punto final, ya no puede enviar ni recibir mensajes desde las interfaces de la aplicación Aircall. Para que los usuarios vuelvan a enviar y recibir mensajes en las aplicaciones Aircall, la configuración debe eliminarse del número.

Ejemplos de casos de uso

• Cree una integración para que los usuarios puedan ver y responder mensajes de texto directamente desde una herramienta externa ( consulte el blog para obtener más inspiración)
• Envíe mensajes no conversacionales como códigos de verificación de un solo uso para fines de autenticación de dos factores, confirmaciones de pedidos automatizadas o notificaciones de entrega por SMS.
• Envíe mensajes no conversacionales para contenido de marketing y promoción a través de SMS

Este artículo y tutorial explican con más detalle cómo aprovechar el punto final Enviar mensaje con un número de Aircall.

Opción 2: Punto final 'Enviar mensaje en conversación del agente'

Al utilizar el punto de conexión Enviar mensaje en conversación de agente con un número de Aircall, los SMS enviados & recibidos se pueden ver directamente en las aplicaciones de Aircall (a diferencia de la opción 1).

❌ El envío de MMS a través de API no es compatible actualmente con esta opción

✅ Los SMS enviados & recibidos se pueden ver en las aplicaciones de Aircall y a través de Webhooks de eventos de mensajes

⚠️ Esta opción combina la automatización y la capacidad de los usuarios de Aircall de continuar la conversación como se muestra a continuación.

Ejemplos de casos de uso

• Envíe un mensaje automático para saludar a los clientes que envíen un mensaje de texto a su número de Aircall. Infórmeles que recibirán asistencia en breve (captura de pantalla a continuación). Esto también ilustra cómo se muestran los mensajes enviados a través de la API con “Herramienta externa” como nombre del remitente en las aplicaciones de Aircall.

• Activación de mensajes en función de las actividades de CRM. Por ejemplo, si un cliente pasa a una etapa específica, la API puede enviar un mensaje para interactuar con el cliente y cualquier respuesta aparece en Aircall para que un miembro del equipo continúe la conversación.

Como se muestra arriba, los clientes pueden responder a los mensajes enviados a través de API, y esas respuestas se mostrarán directamente en la vista de conversación para que los usuarios de Aircall tengan visibilidad y continuidad mientras se comunican con los clientes.

artículo explica con más detalle cómo aprovechar punto de conexión Enviar mensaje en conversación agente un número .

Funciones y normativas de mensajería de la API de Aircall

Independientemente de la herramienta que utilice para enviar SMS, se siguen aplicando los estándares de la industria y las regulaciones locales.

En los EE. UU. o Canadá, el envío de SMS de forma automática y para contenido de marketing es aceptable siempre que el número esté registrado para el propósito adecuado (consulte el artículo sobre Registro A2P 10DCL y número gratuito ) y que pueda demostrar el consentimiento.

Las líneas móviles están pensadas para ser personales, es decir, solo deben estar asociadas a un único agente. Al utilizar la API con líneas móviles, debe asegurarse de que solo dicho agente controle el caso de uso implementado.

En Francia, por ejemplo, las líneas móviles están destinadas únicamente a casos de uso personal y conversacional, lo que significa que está prohibido utilizar la API para enviar SMS de forma automática. Sin embargo, es posible mantener una comunicación conversacional a través de la API.

⚠️ Busque orientación local para asegurarse de que está configurando casos de uso que cumplan con las normas.

Consideraciones al utilizar la API de mensajería

Requisitos reglamentarios

• La configuración de códigos largos de EE. UU. o números gratuitos de EE. UU. y Canadá solo funcionará para números completamente registrados.
• Solo permitimos envíos nacionales, con excepción de mensajes entre EE. UU. y Canadá, igual que el comportamiento descrito para mensajería directa desde aplicaciones Aircall .

Límites de tarifas

• La API de Aircall limita la cantidad de solicitudes a 60 por minuto, independientemente del punto final utilizado. También se aplican algunas restricciones específicas para evitar el uso excesivo de la función de envío de mensajes. Aircall implementa límites específicos por hora, día y mes que son diferentes para cada tipo de número y país. Estos límites están sujetos a cambios sin previo aviso para garantizar un uso adecuado.
• A los números de EE. UU. y Canadá se les asignan límites de segmentos de SMS salientes de 1000 por hora, 10 000 por día y 20 000 por mes.
• Las líneas móviles francesas tienen un límite de 100 llamadas por hora, 1000 llamadas diarias y 10 000 llamadas mensuales para garantizar casos de uso conversacional.
• Otros límites de línea son 500 segmentos SMS salientes por hora, 2000 por día y 20 000 por mes.

Precios

El acceso a la API para enviar mensajes está incluido en el plan Profesional. Comuníquese con su Gerente de Éxito del Cliente o con el equipo de soporte si está interesado en actualizar su plan de suscripción.

• Las tarifas por volumen enviado son las mismas que las tarifas cuando se envía a través de las aplicaciones Aircall.
• El volumen proveniente de fuentes API y de aplicaciones se sumará en sus facturas.

Para continuar con la opción 1, continúe leyendo: Introducción al envío de mensajes mediante la API de Aircall .

Para continuar con la opción 2, continúe leyendo: Introducción al punto final "Enviar mensaje en conversación del agente" en la API de Aircall