# Funnelchat API · v0 > API para armar tu propio Funnelchat sobre WhatsApp: piezas para mandar y recibir mensajes, manejar grupos y números y guardar datos de tus contactos, con tus flujos, tus tiempos y tu lógica. Llamás con una clave de API (`Authorization: Bearer |fc_live_…`) a una sola URL base y recibís eventos firmados por webhook. Funnelchat aplica las reglas de WhatsApp (ventana de 24 horas, frenos contra spam, ritmo por número) y opera la entrega. v0 en desarrollo: cambia sin aviso. Antes de programar, tené en cuenta: la API tiene una sola URL base, `https://api.funnelchat.com`, para las tres áreas, y la URL de cada llamada es esa URL base + la ruta completa `/api/v1/…` que muestra el portal; el envío con clave pide el permiso `conversations:send` y sigue las reglas de WhatsApp; Funnelchat todavía no registra bajas: si un contacto pide que no le escriban más, respetalo en tu sistema; en communities, en v0, `communities:write` solo administra suscripciones de webhooks; algunas respuestas exponen identificadores internos que no son estables; la firma de webhooks es `X-Funnelchat-Signature: t=,v1=.")>`. ## Documentación - [Introducción](docs/index.md): Con la API de Funnelchat armás tu propio sistema sobre WhatsApp, con tus flujos, tus tiempos y tu lógica. Qué es, qué hace nuestra capa por vos y qué tenés que saber antes de integrar. - [Primeros pasos](docs/primeros-pasos.md): La URL base única de la API, cómo autenticarte con tu clave, un ejemplo de lista y de paginación, los errores comunes, el id de cada pedido y los límites de llamadas. - [Guía rápida](docs/guia-rapida.md): Crear una clave, hacer la primera llamada, suscribirse a message.received y verificar la firma de cada entrega. - [Armá tu propio flujo](docs/armar-tu-flujo.md): Un flujo completo con tus tiempos y tu lógica: te llega un mensaje, esperás, decidís, respondés con texto o con una plantilla y te enterás si lo leyeron. - [Autenticación y permisos](docs/autenticacion.md): El formato de la clave, los permisos por dominio, qué está abierto a claves y los errores que devuelven el portero y la entrada de la API. - [Mensajes](docs/mensajes.md): Todo lo que podés mandar y recibir en una conversación 1:1, qué responde cada envío y cómo saber qué puede hacer cada número. - [Estados de mensaje](docs/estados-de-mensaje.md): Saber qué pasó con cada mensaje que mandaste —en cola, enviado, entregado, leído o falló—, por el aviso message.status_changed o consultando el mensaje. - [Grupos](docs/grupos.md): Tu propia gestión de grupos de WhatsApp, sin pasar por nuestras campañas: qué se puede leer y qué avisos te llegan de lo que pasa adentro. - [Números](docs/numeros.md): Tus números de WhatsApp, oficiales de Meta o por QR, con la misma API: estado, salud, conexión por QR y qué puede hacer cada uno. - [Contactos y datos](docs/contactos-y-datos.md): Contactos, etiquetas, campos personalizados y notas, para guardar en Funnelchat lo que tu flujo necesita. - [Cómo funcionan](docs/webhooks.md): Cómo suscribirte, qué vas a recibir, cómo verificar la firma, los reintentos y qué hacer en tu receptor. - [Catálogo de eventos](docs/eventos.md): Los eventos que emite hoy cada área, con su payload de ejemplo, y los que están planificados. - [Reglas de WhatsApp](docs/reglas-de-whatsapp.md): La ventana de 24 horas, los frenos contra spam y el ritmo por número que aplica Funnelchat a cada envío, los errores que devuelve y lo que todavía no hacemos (bajas). - [Funciones de Funnelchat](docs/funciones-de-funnelchat.md): Si ya usás Funnelchat, desde la API podés consultar lo que armaste en el panel —flows, campañas, difusiones, tableros, lead score, ventas, programados y alertas—. No hace falta para construir lo tuyo. - [Referencia](docs/referencia.md): Todos los endpoints de la API v0, con las piezas primero, ejemplos en varios lenguajes y prueba en vivo. - [Procedencia](docs/procedencia.md): De qué commit y a qué hora salió cada especificación que muestra el portal, y qué partes se escriben a mano. - [Kit para asistentes de IA](docs/kit-para-ia.md): Skills para que Claude Code, Codex o Cursor programen contra la API de Funnelchat sin inventar rutas, campos ni reglas. Qué es, cómo se instala, cómo se prueba y qué hace y qué no. ## Kit de skills para asistentes de IA - [Kit para asistentes de IA](docs/kit-para-ia.md): 11 skills para Claude Code, Codex y Cursor —una por pieza de la API, una de arquitectura y una de prueba de instalación— con las operaciones de la especificación unificada, las reglas de WhatsApp y límites de ejecución. Se instalan con `npx skills add Funnelchat20/developers-portal --skill '*'`; el repositorio todavía es privado. ## Especificaciones OpenAPI (instantáneas) - [Toda la API](specs/funnelchat.json): la especificación principal. OpenAPI 3.1 con `servers` `https://api.funnelchat.com` y rutas completas `/api/v1/…`: 237 operaciones de las tres áreas, cada una con el permiso que pide (`x-fc-permission`) y el área que la atiende según el borde de la API (`x-fc-domain`). - [Conversations](specs/conversations.json): OpenAPI 3.1.2, `servers` `https://api.funnelchat.com/api/v1` (sus `paths` son relativos a eso: dan la misma URL que `https://api.funnelchat.com` + `/api/v1/…`), 152 operaciones; instantánea 68cce1b4e, 2026-10-22 16:30 (-03:00). Copia con notas de v0: [specs/conversations.anotada.json](specs/conversations.anotada.json). - [Communities](specs/communities.json): OpenAPI 3.1.2, `servers` `https://api.funnelchat.com/api` (sus `paths` son relativos a eso: dan la misma URL que `https://api.funnelchat.com` + `/api/v1/…`), 53 operaciones; instantánea 6f32f0b4 (árbol con cambios sin commitear), 2026-10-22 09:46 (-03:00). Copia con notas de v0: [specs/communities.anotada.json](specs/communities.anotada.json). - [Accounts](specs/accounts.json): OpenAPI 3.1.2, `servers` `https://api.funnelchat.com/api/v1` (sus `paths` son relativos a eso: dan la misma URL que `https://api.funnelchat.com` + `/api/v1/…`), 68 operaciones; instantánea 300cc8435, 2026-10-22 09:46 (-03:00). Copia con notas de v0: [specs/accounts.anotada.json](specs/accounts.anotada.json). ## Optional - [llms-full.txt](llms-full.txt): todo lo anterior en un solo archivo, más un resumen de cada endpoint (método, ruta, para qué, permiso, disponibilidad en v0, parámetros y cuerpo).