Ingeniería "Done-For-You"

Así conectamos tu mundo.

Aunque nuestro equipo se encarga de todo el desarrollo, exponemos nuestra API para que entiendas la profundidad de las integraciones posibles. Utilizamos estos endpoints para que tu ERP (SAP, Oracle) o CRM legado "hable" fluidamente con nuestros Agentes de IA.

Sincronización Bidireccional

Nuestros ingenieros configuran webhooks para que, si un dato cambia en tu sistema, se refleje instantáneamente en el perfil del cliente en Quabund.

Acciones Disparadas

Usamos la API para que eventos externos (ej: "Formulario Web Enviado") disparen secuencias de WhatsApp automáticas sin intervención humana.

Cómo habilitamos tu acceso

→En base a lo que requieran, personalizamos la conexión, habilitamos el Token e indicamos las mejores prácticas.
→Estas son las APIs más usadas comúnmente. Tenemos más APIs, pero las mantenemos ocultas por seguridad.
→Si tienen alguna idea más allá de lo que presenta la documentación pública, nos indican y les habilitamos el acceso.

Seguridad & Acceso

Como parte del servicio de implementación, generamos y gestionamos las credenciales seguras (API Tokens). Tu equipo de TI no necesita preocuparse por la rotación de claves; nosotros mantenemos el túnel seguro.

La autenticación se realiza con un API Token enviado en el header X-ACCESS-TOKEN de cada petición.

Header de autenticación (en cada request)

X-ACCESS-TOKEN: tu_api_token_seguro

Contactos

Cómo mantenemos tu base de datos unificada y actualizada.

Consulta de Perfil Enriquecido

GEThttps://chat.quabund.ai/api/contacts/{contact_id}

Utilizamos este endpoint cuando necesitamos mostrar el historial de chat o datos de IA dentro de tu propio CRM o Dashboard interno. Permite que tus sistemas "consulten" a Quabund sobre el estado de un cliente.

Parámetros Clave

contact_id(integer)REQ

Identificador del cliente en la base Quabund.

Respuesta: Datos que entregamos a tu sistema

{
  "id": 39201,
  "first_name": "Juan",
  "phone": "+5491122334455",
  "tags": [
    { "id": 101, "name": "Vip" },
    { "id": 102, "name": "Interesado 2024" }
  ],
  "custom_fields": [
    { 
      "name": "empresa", 
      "value": "Tech Corp" 
    }
  ],
  "last_interaction": 1709238400
}

Sincronización y Triggers (Web Form)

POSThttps://chat.quabund.ai/api/contacts

Este es el endpoint más potente. Lo configuramos en tus Landing Pages o Formularios Web.

Por ejemplo: Cuando un usuario llena un formulario en tu web, usamos esta API para crear el contacto en Quabund y ejecutar una automatización inmediata (como enviar un Template de WhatsApp de bienvenida).

Estructura del Payload

phone(string)REQ

Teléfono con código de país. Identificador único del contacto.

first_name(string)

Nombre del lead.

last_name(string)

Apellido del lead.

email(string)

Correo del contacto.

gender(string)

male | female | unknown.

actions(array)

Qué debe hacer Quabund al recibir el dato: etiquetar, guardar un campo o disparar un flujo.

Ejemplo Real: Formulario Web -> WhatsApp Template

{
  "phone": "+5215512345678",
  "first_name": "Maria",
  "last_name": "Gomez",
  "email": "maria@empresa.com",
  "gender": "female",
  "actions": [
    {
      "action": "add_tag",
      "tag_name": "Lead Web"
    },
    {
      "action": "set_field_value",
      "field_name": "origen",
      "value": "Landing Black Friday"
    },
    {
      "action": "send_flow",
      "flow_id": 15542
    }
  ]
}

Al usar "send_flow", el cliente recibe el WhatsApp segundos después de enviar el formulario.

Pipelines (Ventas)

Gestión de Oportunidades. Conecta Quabund con tu sistema de facturación o gestión de proyectos.

Lectura de Estado

GEThttps://chat.quabund.ai/api/pipelines/{id}/opportunities/{op_id}

Si tienes un dashboard externo (ej: PowerBI), usamos este endpoint para inyectar el estado real de tus oportunidades comerciales gestionadas por la IA.

Parámetros

pipeline_id(integer)REQ

ID del embudo de ventas.

opportunity_id(integer)REQ

ID de la oportunidad.

Response

{
  "id": 9921,
  "title": "Venta Licencia Enterprise",
  "value": 5000,
  "status": "open",
  "stage": {
    "id": 104,
    "name": "Negociación"
  }
}

Crear Oportunidad Automática

POSThttps://chat.quabund.ai/api/pipelines/{id}/opportunities

Configuramos este endpoint para que eventos críticos en tu sistema (ej: "Carrito Abandonado" o "Suscripción Vencida") creen automáticamente una tarjeta en el Pipeline de Ventas, alertando a los agentes de IA para iniciar el recupero.

Configuración

title(string)REQ

Nombre del deal.

contact_id(integer)REQ

A quién contactar.

stage_id(integer)REQ

Etapa inicial (ej: 'Por Contactar').

value(number)

Valor estimado.

Ejemplo: Crear Deal por Carrito Abandonado

{
  "title": "Recupero Carrito #9922",
  "contact_id": 39201,
  "stage_id": 101, 
  "value": 1200,
  "status": "open",
  "priority": "high",
  "custom_fields": [
    {
      "id": 55,
      "value": "Producto: iPhone 15"
    }
  ]
}