Uso de la API

Última actualización el Nov 11, 2024

Uso de la API para integraciones personalizadas y ejemplos prácticos

La API de Waclis permite a los desarrolladores crear integraciones personalizadas que conecten la plataforma con sistemas externos y herramientas específicas. Gracias a la flexibilidad de la API, es posible automatizar tareas, mejorar la productividad del equipo, y sincronizar datos entre Waclis y otros sistemas clave de la organización.


Casos de uso para integraciones personalizadas

  1. Sincronización de contactos con un CRM

    • Una integración que sincronice los contactos de Waclis con un CRM permite mantener una base de datos de clientes centralizada y actualizada. Con la API de Waclis, puedes capturar nuevos contactos y actualizaciones, enviándolos automáticamente a tu CRM.
  2. Automatización de encuestas de satisfacción

    • Utilizando los datos de conversaciones de Waclis, puedes crear un flujo automatizado para enviar encuestas de satisfacción al finalizar una conversación. Esta integración puede utilizar un sistema externo de encuestas y alimentar los resultados de vuelta en Waclis para el análisis de satisfacción del cliente.
  3. Registro de actividades en una herramienta de análisis

    • Integrar Waclis con una herramienta de análisis permite registrar eventos de interacción en tiempo real, como el inicio de una conversación o el cambio de estado de un ticket. Con la API, puedes sincronizar estas métricas en tu plataforma de análisis para tener un seguimiento completo de la experiencia del cliente.

Autenticación y configuración básica de la API

Para usar la API de Waclis en una integración personalizada, es necesario autenticar cada solicitud con un token de acceso. Este token permite que tu sistema externo acceda a los datos de Waclis y realice acciones según los permisos otorgados.

  1. Obtener el token de acceso

    • En Waclis, dirígete a Ajustes del perfil para acceder el token de acceso. Este token debe mantenerse seguro.
  2. Incluir el token en los encabezados

Para cada solicitud API, incluye el token en los encabezados:
http Authorization: Bearer tu_token_de_acceso


Ejemplos prácticos de integración usando la API

1. Sincronización de contactos con CRM externo

  1. Descripción: Este ejemplo muestra cómo crear un flujo que sincronice contactos de Waclis en un CRM externo cada vez que se crea o actualiza un contacto en Waclis.

  2. Proceso:

    • Configura un Webhook en Waclis para los eventos contact_created y contact_updated.

    • Crea una función en tu sistema que reciba el payload de contacto desde el Webhook y lo envíe a la API del CRM para crear o actualizar la información del cliente.

Ejemplo de código:
python import requests

Datos del payload recibido desde el Webhook

payload = {

"id": 456,

"nombre": "Juan Pérez",

"email": "juan@example.com"

}

Enviar los datos al CRM

crm_endpoint = "https://api.crm.com/contacts"

headers = {"Authorization": "Bearer crm_api_token"}

response = requests.post(crm_endpoint, json=payload, headers=headers)

if response.status_code == 201:

print("Contacto creado en CRM.")


2. Enviar encuestas de satisfacción al finalizar la conversación

  1. Descripción: Utiliza la API para automatizar el envío de encuestas de satisfacción al finalizar una conversación.

  2. Proceso:

    • Configura un Webhook en Waclis para el evento conversation_status_changed y define que este evento se active cuando el estado cambie a “cerrada”.

    • Crea un flujo que reciba la notificación y envíe una encuesta de satisfacción al contacto de la conversación.

Ejemplo de flujo:
python import requests

def enviar_encuesta(contacto_email):

encuesta_url = "https://api.encuesta.com/send"

data = {

"email": contacto_email,

"encuesta_id": "12345"

}

headers = {"Authorization": "Bearer api_key_encuesta"}

response = requests.post(encuesta_url, json=data, headers=headers)

return response.status_code

Llamar a la función al recibir el Webhook

email_cliente = "cliente@example.com"

status_code = enviar_encuesta(email_cliente)

if status_code == 200:

print("Encuesta de satisfacción enviada.")


3. Generación automática de tickets en una herramienta de soporte

  1. Descripción: Cuando se crea una nueva conversación en Waclis, esta integración crea automáticamente un ticket en una herramienta de soporte externo, lo que facilita el seguimiento de casos complejos.

  2. Proceso:

    • Configura un Webhook en Waclis para el evento conversation_created.

    • Usa la API de la herramienta de soporte para crear un ticket utilizando los datos de la conversación.

Ejemplo de solicitud:
python import requests

def crear_ticket_soporte(conversation_data):

soporte_url = "https://api.soporte.com/tickets"

headers = {"Authorization": "Bearer soporte_api_token"}

response = requests.post(soporte_url, json=conversation_data, headers=headers)

return response.status_code

Datos de la conversación desde Waclis

conversation_data = {

"titulo": "Nueva consulta de soporte",

"descripcion": "Cliente ha iniciado una nueva conversación.",

"prioridad": "Alta",

"cliente_email": "cliente@example.com"

}

status_code = crear_ticket_soporte(conversation_data)

if status_code == 201:

print("Ticket de soporte creado.")


Consejos para el uso efectivo de la API en integraciones personalizadas

  • Maneja los errores de API: Al integrar Waclis con otros sistemas, asegúrate de manejar posibles errores en las solicitudes y recibir confirmaciones de éxito.

  • Aprovecha los Webhooks para automatizar eventos: Configura Webhooks que activen las integraciones solo en momentos relevantes (como al crearse una conversación), lo que facilita flujos de trabajo eficientes.

  • Protege los datos y accesos: Guarda el token de acceso de forma segura y utiliza conexiones HTTPS para enviar y recibir datos.

Accede a la documentación del API en AQUI