Connectors Meta Business Agents: Integraciones con Sistemas Externos

Connectors: Integraciones con Sistemas Externos

Conecta tu Agente a APIs y Datos de tu Negocio

¿Qué son los Connectors?

Los Connectors permiten que tu agente llame a APIs externas para acceder a datos en tiempo real de tus sistemas:

CRM (Salesforce, Zoho CRM, HubSpot)
Calendarios (Google Calendar, Outlook, Calendly)
Inventario (Shopify, WooCommerce)
Facturación (SAP, NetSuite, Odoo)
Soporte (Zendesk, Freshdesk, Jira)
Bases de datos personalizadas

Resultado: El agente responde con información actualizada de tus sistemas reales.

Ejemplo Sin Connector

Cliente: "¿Cuál es el estado de mi orden #12345?"
Agente: "Revisaré tu pedido. Los pedidos tardan 3-5 días."

Ejemplo CON Connector

Cliente: "¿Cuál es el estado de mi orden #12345?"
[El agente llama a tu API de inventario]
Agente: "Tu orden #12345 salió hoy del almacén. 
Llegará mañana entre 2-5 PM. Número de seguimiento: TR123456789"

Estructura de un Connector

Todo Connector necesita 4 partes:

1. Base URL

El dominio de tu API:

https://api.tuempresa.com

2. Authentication (Autenticación)

Cómo tu API valida solicitudes:

Opción 1: API Key

Header: Authorization: Bearer sk_live_abc123def456

Opción 2: OAuth

Requiere login. Meta maneja el flujo automático.

Opción 3: Basic Auth

Header: Authorization: Basic base64(usuario:contraseña)

3. Tools (Herramientas/Endpoints)

Las acciones que el agente puede hacer:

GET /orders/{order_id}  → Obtener estado de orden
GET /customers/{email}  → Obtener datos de cliente
POST /tickets          → Crear ticket de soporte
GET /inventory         → Consultar stock

4. Parameters (Parámetros)

Los datos que el agente envía a cada endpoint:

GET /orders/{order_id}
Parameters:
  - order_id (required) → ID de la orden
  - format (optional)   → json/xml

Casos de Uso por Industria

E-commerce

Connector: Inventario + Órdenes

Endpoints:

GET /products/{sku} → Stock disponible
GET /orders/{order_id} → Estado de envío
GET /tracking/{order_id} → Número de seguimiento
POST /returns → Crear devolución

Beneficio: Cliente obtiene respuesta real en 2 segundos sin intermediarios.

SaaS

Connector: CRM + Datos de Cuenta

Endpoints:

GET /accounts/{email} → Datos de cuenta
GET /subscriptions/{account_id} → Plan actual
GET /usage/{account_id} → Uso del mes
POST /support-tickets → Crear ticket

Beneficio: Soporte técnico sin requierir acceso manual a sistemas.

Servicios

Connector: Calendario + CRM

Endpoints:

GET /availability → Horarios disponibles
POST /bookings → Crear cita
GET /clients/{phone} → Historial del cliente
PUT /clients/{client_id} → Actualizar info

Beneficio: Agencia agenda citas sin intervención humana.

Cómo Crear un Connector

Paso 1: Ve a Advanced › Connectors

En WOZTELL:

Channels
→ Tu canal
→ Meta AI Agent
→ Scroll down
→ "Advanced"
→ "Connectors"

Nota: Si no ves "Connectors", puede estar deshabilitado. Contacta soporte@woztell.com.

Paso 2: Haz Clic en "Add Connector"

Paso 3: Completa Base URL

https://api.tuempresa.com

Paso 4: Elige Método de Autenticación

API Key (Recomendado para APIs simples)

Type: API Key
Location: Header (Bearer)
Key: sk_live_abc123def456

OAuth (Para sistemas complejos como Salesforce)

Requiere que ya tengas credenciales OAuth en tu API
WOZTELL maneja el flujo automático

Basic Auth

Username: tu_usuario
Password: tu_contraseña

Paso 5: Agrega Tools (Endpoints)

Haz clic en "Add Tool" para cada endpoint que el agente pueda usar:

Ejemplo:

Tool 1: Get Order Status
Method: GET
Path: /orders/{order_id}
Parameters:
  - order_id (string, required)

Tool 2: Get Product Stock
Method: GET
Path: /products/{sku}/stock
Parameters:
  - sku (string, required)

Paso 6: Prueba

WOZTELL debería permitirte hacer un test call:

GET /orders/123
Response: {
  "order_id": "123",
  "status": "shipped",
  "tracking": "TR123456789"
}

Paso 7: Guarda

El Connector aparecerá en la lista. Ahora los Skills pueden usarlo.

Usar un Connector en un Skill

Una vez el Connector está configurado, los Skills pueden accederlo:

Ejemplo: Skill "Check Order Status"

Name: "Check Order Status"

When to use it:
"When customer asks about their order status or tracking"

What the agent should do:
"1. Ask for the order ID if not provided
2. Call the Connector: GET /orders/{order_id}
3. Respond with status and tracking number
4. If shipped, mention estimated delivery date"

Meta Business Agent automáticamente:

Extrae el order ID de la conversación
Llama al Connector
Recibe la respuesta en JSON
Integra la data en la respuesta del agente

Tipos de Métodos HTTP

Método	Qué Hace	Ejemplo
GET	Lee datos	GET /orders/123 → obtener estado
POST	Crea datos nuevos	POST /tickets → crear ticket
PUT	Actualiza datos existentes	PUT /customers/123 → actualizar perfil
DELETE	Elimina datos	DELETE /bookings/456 → cancelar cita

Ejemplos Reales

Ejemplo 1: Shopify (E-commerce)

API Base:

https://tu-tienda.myshopify.com/admin/api/2023-04

Authentication:

API Key en header:
Authorization: Bearer tu_access_token

Tools:

1. GET /products/{id}.json
   → Obtener detalles de producto

2. GET /orders/{id}.json
   → Obtener estado de orden

3. POST /fulfillments/{order_id}.json
   → Actualizar estado de envío

Ejemplo 2: Google Calendar

API Base:

https://www.googleapis.com/calendar/v3

Authentication:

OAuth (Google te da access token)

Tools:

1. GET /calendars/{calendar_id}/events
   → Obtener eventos del día

2. POST /calendars/{calendar_id}/events
   → Crear evento/cita

Ejemplo 3: Zendesk (Soporte)

API Base:

https://tu-dominio.zendesk.com/api/v2

Authentication:

Basic Auth:
Usuario: tu_email@example.com
Password: tu_api_token

Tools:

1. GET /users/search?email={email}
   → Buscar cliente

2. POST /tickets
   → Crear ticket

3. GET /tickets/{id}
   → Obtener detalles de ticket

Limitaciones y Consideraciones

⚠️ Rate Limits

Tu API puede tener límites (ej: 100 llamadas/minuto). Monitorea:

Cuántas llamadas hace el agente
Si alcanzas límites de rate
Implementa queue si es necesario

⚠️ Latencia

Las llamadas a API toman tiempo. Si tu API tarda >5 segundos:

Cliente ve delay en respuesta
Experiencia pobre
Solución: Optimiza tu API o cachea datos

⚠️ Seguridad

Never compartir credenciales en chat o documentos:

API Keys están en el servidor WOZTELL (seguro)
No expongas secretos en Skills públicos
Usa variables de entorno

⚠️ Datos Sensibles

El agente puede exponer datos que no deberían ser públicos:

Malo: "Tu saldo es $5,000 y tu SSN es 123-45-6789"
Bueno: "Tu saldo es $5,000. Para cambios, ¿necesitas soporte?"

Troubleshooting

Problema	Causa	Solución
"El Connector no responde"	Tu API está down	Verifica que tu servidor esté online
"Error 401 Unauthorized"	API Key / Auth incorrecta	Verifica credenciales en WOZTELL
"Timeout (>5 segundos)"	Tu API es lenta	Optimiza consultas o usa cache
"Respuesta malformada"	API retorna formato incorrecto	Verifica que retorne JSON válido

Para Empezar

¿Tienes una API lista?

Asegúrate que sea HTTPS (no HTTP)
Documenta los endpoints disponibles
Obtén credenciales de autenticación
Contacta soporte@woztell.com para configurar

¿No tienes API?

Usa plataformas como Make o Zapier
Crea webhooks que Connectors pueda llamar
Construye una API simple (Python Flask, Node Express)

¿Necesitas Ayuda?

Configurar Connector: soporte@woztell.com
API custom: Equipo de desarrollo WOZTELL
Integración con sistema existente: Evaluamos viabilidad