Public API
Crea integraciones con la API GraphQL de Chatfuel: tokens y usuarios virtuales, solicitudes y errores, y una referencia de cada operación.
Última actualización
Crea integraciones con la API GraphQL de Chatfuel: tokens y usuarios virtuales, solicitudes y errores, y una referencia de cada operación.
Artículos de esta sección
Índice de operaciones de la API
Todas las queries, mutations y subscriptions de la Public API de Chatfuel, con el rol que requieren y un enlace a su referencia.
API de documentación para agentes de IA
Un enlace con el que tu asistente de IA o agente de código busca en el centro de ayuda y en la referencia de la Public API. Sin iniciar sesión.
Descripción general de la Public API de Chatfuel
La Public API de Chatfuel es una API GraphQL para gestionar bots, contactos, mensajes y flujos desde tu servidor con tokens de usuarios virtuales.
Guía de inicio rápido de la Public API de Chatfuel
Crea un token de API personal, encuentra el ID de tu bot, crea un usuario virtual y haz tu primera consulta y mutación en la Public API en unos diez minutos.
Autenticación y tokens de la Public API
Envía un token de API personal (CLI token) o un token de usuario virtual como token Bearer. Usa usuarios virtuales a diario y el token personal para la cuenta.
Usuarios virtuales en la Public API de Chatfuel
Un usuario virtual es un Editor o Agent solo para la API en un bot, con su propio token. Créalo, rótalo, cambia su rol o elimínalo con tu token de API personal.
Cómo hacer solicitudes a la Public API
Envía solicitudes POST de GraphQL a panel.chatfuel.com/graphql, pagina con cursores, suscríbete por WebSocket, sube archivos y respeta los límites.
Errores y códigos de error de la Public API
Los errores de la Public API llegan en el arreglo errors de GraphQL. Lee extensions.code, como Unauthorized o NotEnoughPermissions, y guarda el traceId.
Versionado y obsolescencia de la Public API
La Public API tiene un solo endpoint sin versión. Los campos publicados nunca se rompen: los cambios son aditivos y lo que se elimina antes se marca obsoleto.
Referencia de la API: bots y cuenta
Lee un bot y la cuenta actual con bot(id:) y currentUser. Renombrar, eliminar y crear bots y espacios de trabajo requiere el token de API personal.
Referencia de la API de equipo y roles
Lista miembros e invitaciones, y crea, rota, cambia de rol o elimina usuarios virtuales. Cambiar el equipo requiere el token de API personal de un Admin.
Referencia de la API de contactos
Busca, lee y actualiza contactos de Chatfuel: atributos, nombres, notas, responsables y etapas de venta, segmentos, importación y exportación CSV y eventos.
Referencia de la API de mensajería
Lee conversaciones y envía texto, archivos y plantillas de WhatsApp en WhatsApp, Instagram, Facebook, TikTok y el widget del sitio web con la Public API.
Referencia de la API de flows
Lee y crea flows de Chatfuel con la Public API: flows y grupos, bloques y conexiones, componentes de mensaje y acción, reglas de palabras clave y Test chat.
Referencia de la API de Fuely AI y Automations
Configura Fuely AI con la Public API: Automations y sus ajustes, conocimiento de la empresa, reglas de reserva y broadcasts de WhatsApp.
Referencia de la API de reservas y catálogo
Gestiona reservas, especialistas, productos y servicios con la Public API: lee el calendario, crea y actualiza citas y sincroniza Google Calendar.
Referencia de la API de canales
Lee los canales conectados de un bot y gestiona WhatsApp, Instagram, Facebook, TikTok y el widget web. Conectar canales requiere el token personal.
Referencia de la API de archivos y tareas
Sube archivos, lee sus URL y sigue trabajos largos, como exportaciones de contactos y sincronizaciones de Google Calendar, con getTask y taskUpdated.