Public API

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

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.

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.

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.

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.

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.

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.

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 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 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 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 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 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: 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.

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.

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.