Funnelchat APIKit para asistentes de IA
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.
Si le pedís a tu asistente de IA que programe tu integración, este kit le enseña la API de Funnelchat tal como es: las rutas, los campos, los permisos, las reglas de WhatsApp y lo que no existe. Así no inventa, y vos no perdés tiempo ni arriesgás tu número.
Qué es
Un conjunto de skills: instrucciones y referencias que el asistente carga solo cuando las necesita. Hay una por pieza de la API, una de arquitectura que arma el plan de tu integración y deriva cada parte a la skill que corresponde, y una para probar la instalación.
| Skill | Qué cubre |
|---|---|
funnelchat-api-authentication | Autenticación y permisos. La URL base, la clave, los permisos, qué está abierto a claves y los errores del portero. |
funnelchat-messages | Enviar mensajes. Enviar texto, archivos, botones, listas, plantillas, tarjetas, reacciones y reenvíos, con la ventana de 24 horas, los frenos y el ritmo por número. |
funnelchat-inbound-messages | Recibir mensajes y leer conversaciones. Recibir message.received con un receptor firmado y leer conversaciones e historial. |
funnelchat-webhooks | Webhooks y eventos. Suscripciones, catálogo de eventos, firma con código probado, reintentos y entregas. |
funnelchat-contacts | Contactos y datos. Contactos, campos personalizados, etiquetas y notas; sincronizar un CRM sin duplicados. |
funnelchat-templates | Plantillas. Crear, editar y elegir plantillas de WhatsApp y enterarse de su aprobación. |
funnelchat-groups | Grupos. Leer grupos, participantes, entradas y salidas, y sus eventos. |
funnelchat-numbers | Números. Tus números: estado, salud, registros, cola y las operaciones irreversibles. |
funnelchat-account | Cuenta y consumo. Gasto de WhatsApp, contactos activos (MAC) y dominios propios. |
funnelchat-integration-architect | Arquitectura de una integración. Arma el plan de tu integración con las piezas, marca las reglas y lo que no existe, y deriva cada parte. |
funnelchat-developer-kit-smoke-test | Prueba de instalación. Prueba la instalación: responde un texto fijo sin llamar a nada. |
- Sale de la misma fuente que este portal. Las operaciones de cada skill se generan de la especificación unificada y su comportamiento, de estas páginas. El build del portal verifica que el kit esté al día y que cada operación de la API tenga su skill, salvo las Funciones de Funnelchat: el kit las nombra como alternativa, pero no las enseña como piezas.
- Describe la API como está hoy. Lo que un integrador puede usar hoy, y lo que no existe, como que no existe.
- Está en español, con los términos clave también en inglés y en portugués, para que se active con lo que escribas.
Cómo se instala
Repositorio privado
El kit vive en el repositorio de este portal, que todavía es privado: hasta que se publique, el comando funciona solo para quien tiene acceso a ese repositorio.
Con el instalador de skills (npx skills), en la carpeta de tu proyecto:
# Claude Code
npx skills add Funnelchat20/developers-portal --skill '*' -a claude-code
# Codex
npx skills add Funnelchat20/developers-portal --skill '*' -a codex
# Cursor
npx skills add Funnelchat20/developers-portal --skill '*' -a cursor--skill '*'instala todas. Para una sola, poné su nombre:--skill funnelchat-messages. La de arquitectura deriva a las demás, así que conviene tenerlas todas.- A mano, en Claude Code: copiá las carpetas
skills/funnelchat-*del repositorio a.claude/skills/de tu proyecto, o a~/.claude/skills/para usarlas en todos. - Cada skill es una carpeta con su
SKILL.mdy sus referencias: se puede leer como cualquier Markdown.
Cómo se prueba la instalación
Pedile a tu asistente: «Probá la instalación del kit de Funnelchat». Tiene que responder exactamente este texto, sin llamar a ninguna herramienta ni a la red:
Kit de Funnelchat para asistentes de IA: instalado. Para empezar, pedime «armá el plan de mi integración con Funnelchat».Si responde otra cosa o intenta llamar a la API, la skill funnelchat-developer-kit-smoke-test no está instalada o el asistente no la cargó. Para empezar a trabajar, pedile el plan de tu integración: lo arma funnelchat-integration-architect.
Qué hace y qué no
- Te ayuda a programar: arma el plan con las piezas, escribe el código contra las rutas y los campos reales, verifica la firma de los webhooks con el mismo código que probamos acá y te avisa qué reglas de WhatsApp aplican.
- No publica nada ni manda mensajes sin que se lo pidas. Cada skill trae los mismos límites de ejecución: un pedido claro autoriza esa operación y solo esa; tu clave se usa sin mostrarla; el trabajo local no autoriza llamadas reales, y nunca reintenta a ciegas una escritura que no respondió.
- Te pide confirmación antes de lo irreversible, como reiniciar, limpiar o eliminar un número, aunque se lo hayas pedido.
- No sabe más que la API: si algo no está en la especificación, el kit dice que no existe en lugar de adivinarlo.
- No guarda tu clave. La usan tu código o tu terminal, desde una variable de entorno. No hay sandbox: todo lo que haga con tu clave actúa sobre tu cuenta real (Autenticación y permisos).