Agentes Virtuales GuíasVentas y soporte
Guías · Integraciones

API y webhooks (conectar tu propio sistema)

Claves de API para que tu propio sistema lea o cree contactos y prospectos, consulte métricas o chatee con tu agente, y webhooks que avisan a tu servidor cuando pasa algo.

Para qué sirve

Si tienes un sistema propio (tu página, tu punto de venta, una herramienta como n8n), tu programador lo puede conectar con tu agente. Por ejemplo: que cada prospecto que capta tu agente de WhatsApp aparezca solo en tu sistema, o que tu página web mande mensajes a tu agente.

Dónde está

Menú izquierdo → sección 🤖 ASC — Tu Servicio al Cliente → Integraciones (icono de webhook). El título de la pantalla es API & Webhooks. Tiene las pestañas Claves de acceso, Automatizaciones, Uso y Docs.

No la confundas con Integraciones de la sección AAE (Mercado Pago y sistemas conectados).

Cómo se usa

  1. Crear una clave: en Claves de acceso pulsa + Nueva clave, ponle un nombre (ej. "Mi App") y marca los Permisos: Leer contactos, Escribir contactos, Leer leads, Escribir leads, Leer analíticas, Chat con agente, Gestionar webhooks. Pulsa Crear.
  2. Copia y guarda la clave en ese momento: no se vuelve a mostrar.
  3. Crear un webhook: en la pestaña Automatizaciones pulsa + Nueva automatización, escribe la URL de tu servidor y marca los Eventos: Nuevo lead, Lead actualizado, Nueva conversación, Solicitud de escalado, Bot desconectado, Workflow ejecutado, Contacto creado. Pulsa Crear y guarda el Secret que aparece.
  4. Pásale a tu programador la pestaña Docs: dirección base https://agentesvirtuales.mx/v1 y la clave en el encabezado Authorization: Bearer AVAPI_... (también acepta x-api-key).
  5. En cada clave puedes Revocar o Eliminar; en cada webhook, Eliminar. En Uso ves las peticiones totales, las claves activas, el tiempo promedio de respuesta y los endpoints más usados de los últimos 30 días.

Alcances

Limitaciones

Problemas comunes

¿Te quedó alguna duda? Escríbenos y te guiamos paso a paso con tu caso, al instante.

PreguntarnosProbar gratis