Integración de datos de contacto

Introducción

Un aspecto esencial de proporcionar una experiencia de usuario personalizada es la capacidad de acceder y mostrar información relevante del contacto durante las conversaciones. Reach ha introducido una característica avanzada que permite a los negocios enriquecer los datos del contacto integrando su propia API para mostrar información adicional en tiempo real.

Configuración

Navegue a Configuraciones y seleccione Sistemas de terceros.
En Información adicional del contacto, active la opción y proporcione la URL de la API.
(Opcional) Proporcione el nombre a mostrar en la sección de información adicional de contactos.

EJEMPLO

INFORMACION ADICIONAL

API

Esta integración será realizada por peticiones HTTP hacia el API del negocio.
<URL> será la ruta proporcionada en la configuración de Reach.

Path: <URL>/contact
Method: GET

Query Parameters:

alias: El número de teléfono del contacto.

Expected Response:

Explicación de Campos

inputs (array): Un arreglo de objetos que representa un campo de información adicional.
- label (string): La etiqueta o nombre del campo.
- type (string): El tipo de dato esperado para el campo (por ejemplo, ‘text’, ‘number’, ‘date’, etc.).
- value (string): El valor actual del campo.
- placeholder (string): Un texto de sugerencia que se muestra en el campo si no posee un valor.

Casos de Uso

CRM Personalizado: Integre información de su CRM para mostrar historial de compras, preferencias y más.
Programas de Lealtad: Muestre puntos de fidelidad, niveles de membresía y beneficios pendientes para fomentar la retención de clientes.
Verificación de Identidad: Verifique la identidad del cliente para procesos que requieren autenticación durante la conversación.

Buenas Prácticas

Registro proactivo de números telefónicos: Para canales donde el número de teléfono no se captura automáticamente, es esencial que los agentes adopten un enfoque proactivo solicitando y registrando el número de teléfono del cliente de manera temprana en la conversación. Esto permite la utilización efectiva de la integración API.
Consistencia de datos: Asegúrese de que la información proporcionada a través de la API esté actualizada y sea consistente con los registros internos del negocio.
Optimización de respuesta: Minimice los tiempos de respuesta de su API para no ralentizar la experiencia del usuario en la plataforma Reach.
Limitación de campos: Evite sobrecargar la interfaz de usuario con demasiada información. Incluya solo los campos que son relevantes para la interacción con el cliente.
Protección de la privacidad: Proteja la privacidad del cliente al no exponer datos sensibles o personales sin el debido consentimiento y seguridad.
Feedback y Mejoras: Establezca un canal para recibir comentarios de los usuarios sobre la información proporcionada y use este feedback para mejorar la integración.

Integración de pestaña personalizada

Introducción

Esta característica permite a los negocios mostrar información del negocio, accediendo a datos dinámicos a través de una URL configurada. Esta capacidad de personalización es crucial para empresas que buscan mejorar la experiencia de sus usuarios al proporcionar información relevante y oportuna directamente en la interfaz de conversación.

Configuración

Navegue a Configuraciones y seleccione Sistemas de terceros.
En Pestaña personalizada, active la opción y proporcione la URL de la API.
(Opcional) Proporcione el nombre a mostrar en la pestaña personalizada.

EJEMPLO

MÁS DETALLES

API

Esta integración será realizada por peticiones HTTP hacia el API del negocio. <URL> será la ruta proporcionada en la configuración de Reach.

Path: <URL>/category/list
Method: GET

Expected Response:

Explicación de Campos

id (string): Identificador único de la categoría. Se utilizará luego para la siguiente petición como <category_id>.
title (string): Título o nombre de la categoría.

Path: <URL>/category/<category_id>/item/list
Method: GET

Query Parameters:

search: Un valor a buscar dentro de la lista de ítems.

Expected Response:

Explicación de Campos

id (string): Identificador único del ítem.
title (string): Título o nombre del ítem.
status (string): Estado que se desea mostrar en el ítem.
image (string): URL de la imagen a mostrar del ítem.
description (string): Descripción detallada del ítem.

Casos de Uso

Gestión de inventarios: Visualice el estado del inventario y la disponibilidad del producto directamente en la conversación.
Soporte para eventos: Proporcione información sobre eventos próximos, sesiones o talleres relevantes para el cliente.
Documentación y recursos: Ofrezca acceso rápido a manuales, guías de usuario o recursos educativos asociados con servicios o productos.

Buenas Prácticas

Consistencia de datos: Asegúrese de que la información proporcionada a través de la API esté actualizada y sea consistente con los registros internos del negocio.
Optimización de respuesta: Minimice los tiempos de respuesta de su API para no ralentizar la experiencia del usuario en la plataforma Reach.
Feedback y Mejoras: Establezca un canal para recibir comentarios de los usuarios sobre la información proporcionada y use este feedback para mejorar la integración.
Usabilidad: Diseñe la pestaña para una navegación intuitiva y presentación clara de los datos.

Webhooks en Reach

El funcionamiento de los webhooks en la plataforma Reach, que son notificaciones automáticas enviadas cuando ocurren ciertos eventos, como la creación de órdenes o conversaciones. Los webhooks permiten recibir actualizaciones en tiempo real, facilitando la integración y la automatización de procesos.

Qué son los Webhooks

Los webhooks son mensajes que envía Reach a una URL definida por el usuario cada vez que ocurre un evento importante en la plataforma. Estos eventos incluyen la creación de órdenes, actualizaciones de estado de las órdenes, y la creación de conversaciones en los canales de mensajería. Para configurar estos webhooks, es necesario contactar al equipo de soporte de Reach.

Formato de los Webhooks

Cada webhook enviado tiene un formato estándar con algunos campos clave que varían según el tipo de evento. El formato básico es:

_id: Identificador único para cada evento.
type: Nombre del evento (como creación de orden).
timestamp: Fecha y hora en que ocurrió el evento.

Modelos de Datos para Webhooks

Dependiendo del evento, los datos adicionales se encuentran en la sección data y se estructuran en varios modelos de datos. A continuación se describen los modelos disponibles:

PaymentLogModel

Este modelo registra información relacionada con pagos y las respuestas de los proveedores de servicios de pago. Incluye datos como:

Tipo de registro (por ejemplo, “Pago rechazado” o “Aprobado”).
ID de la orden.
Mensaje de respuesta del proveedor.
Código de estado HTTP y el proveedor de pago.

Ejemplo:

OrderModel

Este modelo contiene detalles de una orden, especialmente cuando se crea o cambia de estado. Incluye información como:

Estado de la orden (por ejemplo, “Pendiente” o “Pagada”).
Información del agente que creó la orden.
Detalles de facturación, incluyendo nombre, dirección y monto total.

Ejemplo:

POSRequestModel

Este modelo incluye los datos de la tarjeta y la información personal que se utilizó para realizar una solicitud de pago al proveedor. Los datos incluyen:

Número de tarjeta (últimos cuatro dígitos).
Fecha de expiración de la tarjeta.
Nombre y apellidos del titular.
Dirección, correo electrónico y número de teléfono del cliente.

Ejemplo:

ConversationModel

Este modelo contiene información sobre las conversaciones creadas en Reach. Incluye:

ID de la conversación.
Tipo de canal (como WhatsApp o Messenger).
Perfil del cliente, incluyendo nombre, correo electrónico y número de teléfono.

Ejemplo:

ProfileModel

Este modelo describe la información del perfil de un cliente. Incluye:

Nombre, apellido, correo electrónico y número de teléfono del cliente.

Ejemplo:

Tipos de Eventos

Reach genera distintos tipos de eventos que activan los webhooks. Aquí se detallan algunos de ellos con ejemplos:

payment_order_created: Este evento ocurre cuando se crea una nueva orden. El modelo utilizado es OrderModel (con solo el ID de la orden y el estado en ese momento).

Ejemplo:

payment_status_update: Este evento se activa al cambiar el estado de una orden, como de “Pendiente” a “Pagada”. Incluye detalles como el proveedor de pago, el ID del agente y la información de facturación.

Ejemplo de orden pendiente:

Ejemplo de orden pagada:

payment_log: Registra información de las transacciones y respuestas de los proveedores. Es útil para rastrear el estado de los pagos y cualquier respuesta del proveedor.

Ejemplo:

conversation_created: Este evento ocurre cuando se crea una nueva conversación en Reach, como un nuevo chat en WhatsApp o Messenger. Incluye detalles sobre el canal y el perfil del cliente.

Ejemplo:

Endpoints Integración de Terceros