Herramientas
Las instrucciones para tu agente de IA, los SDK de Node.js, PHP y Python, el CLI, el nodo de n8n y un sandbox para probar sin cuenta.
Instrucciones para tu agente
Las instrucciones de la API para tu agente de IA: cada llamada, cada evento y lo que suele salir mal. Son las mismas de dos formas.
Una skill, para los agentes que usan skills, como Claude Code. Para todos tus proyectos:
curl -fsSL https://developers-portal.funnelchat.app/skill/funnelchat.zip -o /tmp/funnelchat.zip
mkdir -p ~/.claude/skills && unzip -o /tmp/funnelchat.zip -d ~/.claude/skillsPara un solo proyecto, desde su carpeta, cambia ~/.claude/skills por .claude/skills. La usa desde la próxima sesión. Bajar el .zip
Un solo archivo, para cualquier agente. Desde la carpeta de tu proyecto:
curl -fsSL https://developers-portal.funnelchat.app/ia/instrucciones.md -o FUNNELCHAT.mdY una línea en tu AGENTS.md (o en CLAUDE.md): «Para la API de Funnelchat (WhatsApp), lee FUNNELCHAT.md antes de escribir código». Ver el archivo
¿Prefieres que tu agente lo haga todo, hasta tu primer mensaje? Pégale la línea de la guía rápida y sigue estos pasos.
SDK de Node.js
Para JavaScript y TypeScript, con Node 18 o más nuevo. Lee tu clave de FUNNELCHAT_API_KEY.
npm install @funnelchat-hq/sdkSDK de PHP
composer require funnelchat/funnelchat-phpSDK de Python
Con Python 3.9 o más nuevo. Lee tu clave de FUNNELCHAT_API_KEY.
pip install git+https://github.com/Funnelchat20/funnelchat-pythonPronto se instala con pip install funnelchat, desde PyPI. Tu primer mensaje, con el id de tu número y el teléfono con código de país:
from funnelchat import Funnelchat
client = Funnelchat()
client.messages.send_direct(device_id="dev_Ac7Ku7iIZDXJTjdCu0UB1mX", phone="5491122334455", text="¡Hola!")CLI
Conecta un número, manda un mensaje y mira cuándo lo leen, desde la terminal y sin escribir código. Necesitas Node 18 o más nuevo y tu clave.
npx @funnelchat-hq/cli login
npx @funnelchat-hq/cli connect
npx @funnelchat-hq/cli send 5491122334455 "¡Hola!"login guarda tu clave sin mostrarla, connect te da el link con el QR para escanear con WhatsApp y send te muestra el mensaje hasta que lo leen. Si lo instalas con npm install -g @funnelchat-hq/cli, el comando es funnelchat.
También lo usa tu agente de IA: con --json, cada comando devuelve un solo JSON para leer (los pasos que sigue).
Ver el repositorio · Ver en npm
Nodo de n8n
Para usar la API en tus flujos de n8n. En n8n, entra a Settings › Community Nodes, toca Install y escribe:
@funnelchat-hq/n8n-nodes-funnelchatSandbox
Prueba todo en tu compu sin cuenta: imita la API, no manda nada a WhatsApp y no cuesta nada. Necesitas Node 20.11 o más nuevo.
npx @funnelchat-hq/sandboxQueda escuchando en http://127.0.0.1:4010: usa esa dirección en lugar de https://api.funnelchat.com.