Funnelchat para tu asistente de IA
Los pasos para que tu asistente de IA configure Funnelchat en tu compu, con tu clave, hasta tu primer mensaje de WhatsApp.
Esta página está escrita para tu asistente de IA, sea cual sea. Si llegaste por tu cuenta, cópiale la línea de la guía rápida y él la lee.
Para el asistente
La persona te pidió que configures Funnelchat. Sigue estos pasos en orden y detente donde dice. Los comandos son de una terminal de macOS o Linux: en Windows, usa sus equivalentes.
Paso 1: Explícale en una línea qué vas a hacer
Que vas a guardar las instrucciones de la API de Funnelchat en su proyecto y acompañarla hasta su primer mensaje de WhatsApp, en su compu y con su clave.
Paso 2: Detente: la clave
Pídele que cree una clave en el panel de Funnelchat, en Desarrolladores → Crear clave (se muestra una sola vez), y que la guarde en el archivo .env de la carpeta del proyecto o en la variable de entorno FUNNELCHAT_API_KEY. Que no la pegue en el chat. Si no ve Desarrolladores en el panel, tiene que pedirle a Funnelchat que lo active en su cuenta.
# Lo escribe la persona en el .env del proyecto. Va entre comillas simples porque la clave lleva un |
FUNNELCHAT_API_KEY='…'Si la define como variable de entorno en otra terminal, tu sesión no la ve: tiene que definirla antes de abrirte. Espera a que te diga que está lista y comprueba que existe, sin mostrarla:
test -n "$FUNNELCHAT_API_KEY" && echo "FUNNELCHAT_API_KEY: ok"
grep -qs '^FUNNELCHAT_API_KEY=' .env && echo ".env: ok"Si está en el .env, comprueba que .env esté en .gitignore: la clave nunca se sube a un repositorio.
Paso 3: Guarda las instrucciones de la API en el proyecto
Para escribir código con la API más adelante, sin inventar nada. Desde la carpeta del proyecto:
curl -fsSL https://developers-portal.funnelchat.app/ia/instrucciones.md -o FUNNELCHAT.mdY suma esta línea en el AGENTS.md del proyecto, o en el archivo de instrucciones que lees tú (por ejemplo, CLAUDE.md); si no existe, créalo:
Para la API de Funnelchat (WhatsApp), lee FUNNELCHAT.md antes de escribir código.Paso 4: Lleva a la persona hasta su primer mensaje
Con el CLI de Funnelchat (Node 18 o más nuevo), que lee la clave de FUNNELCHAT_API_KEY. Si la clave está en el .env, cárgala en el entorno del comando sin mostrarla: set -a; . ./.env; set +a; npx @funnelchat-hq/cli …. Con --json, cada comando devuelve un solo JSON para leer.
Primero, mira los números de su cuenta y cuéntale lo que encontraste. Muchas cuentas ya tienen uno conectado.
npx @funnelchat-hq/cli numbers listUn número es oficial de WhatsApp si su connection es coexistence o dedicated; por QR, qr. Según lo que encuentres, pregúntale qué prefiere, y no conectes nada sin su respuesta:
- Ya tiene un número conectado: díselo, por ejemplo «Tu cuenta ya tiene conectado Ventas (+54 9 11 …). ¿Lo usamos?». Si tiene varios, pregúntale cuál. Usarlo no conecta nada ni ocupa otro lugar de su plan.
- Tiene un número, pero desconectado: ofrécele reconectar ese mismo número antes que conectar otro; tampoco ocupa otro lugar de su plan.
npx @funnelchat-hq/cli connect --device <id> --no-waitimprime el link para reconectarlo. - No tiene ninguno y quiere usar el suyo: por QR.
npx @funnelchat-hq/cli connect --no-waitimprime el link: muéstraselo. Lo abre en otra pantalla, toca el botón y tiene 10 minutos para escanear el QR con WhatsApp, en Dispositivos vinculados. - No tiene ninguno y prefiere un número de EE. UU. de Funnelchat (oficial): antes, cuéntale que va a iniciar sesión con Facebook y seguir los pasos de Meta con su cuenta de WhatsApp Business; que necesita un medio de pago cargado en Meta, porque Meta le cobra los mensajes; que ocupa un lugar de su plan y cuenta en el tope de números de EE. UU. (hasta 3 por cuenta, menos si su plan tiene menos lugares), y que con un número oficial no se siguen grupos: eso es solo por QR. Si está de acuerdo,
npx @funnelchat-hq/cli connect --us-number --no-waitimprime el link: muéstraselo. En la página elige el número de EE. UU. y sigue los pasos.
Cada link funciona una sola vez y quien lo tiene puede conectar un número a su cuenta: no se lo muestres a nadie más. Cuando te diga que terminó, vuelve a correr numbers list: el número tiene que aparecer conectado. Si pedir el link falla con meta_connect_disabled, el número de EE. UU. no se puede pedir en este momento: díselo y ofrécele conectar el suyo por QR. Si quiere conectar su propio número como oficial de WhatsApp, eso se hace desde el panel de Funnelchat: indícaselo.
El primer mensaje. El teléfono va con código de país (por ejemplo, 5491122334455). Si la cuenta tiene más de un número, send pide --device <id>: usa el que eligió.
npx @funnelchat-hq/cli send <teléfono> "<texto>" # muestra queued → sent → delivered → read- Por un número por QR, el texto sale a cualquier teléfono. El suyo sirve para probar.
- Por un número oficial (el de EE. UU., o el que ya tenía si es oficial), el primer mensaje a un teléfono que no le escribió en las últimas 24 horas tiene que ser una plantilla aprobada: un texto no sale (
window_closed). Para probar, lo simple es que la persona le escriba «hola» a ese número desde su WhatsApp; durante las 24 horas siguientes, a ese teléfono le puedes contestar con texto libre. Para escribirle a alguien nuevo, una plantilla: ver Mandar mensajes.
Siempre:
- Antes de mandar un mensaje, confirma con la persona a quién y qué texto.
- Escríbele solo a quien aceptó recibir mensajes de su negocio.
- Nunca pidas ni muestres la clave en el chat.
- Si el envío falla o se corta, no lo repitas sin preguntarle: el mensaje pudo haber salido.
Paso 5: Proponle lo que sigue
- Seguir un grupo, para enterarse de quién entra y quién sale:
npx @funnelchat-hq/cli groupsmuestra los grupos de su número ynpx @funnelchat-hq/cli groups follow <uid>sigue uno. Ver Grupos. - Recibir los webhooks en su servidor: cuándo leen sus mensajes, quién le escribe y quién entra a sus grupos. Ver Webhooks.
- Integrarlo en su código, con el SDK de Node.js, de PHP o de Python, o con llamadas directas:
FUNNELCHAT.mdtiene cada llamada y cada evento. El de Python todavía no está en PyPI: se instala conpip install git+https://github.com/Funnelchat20/funnelchat-python. Ver Herramientas.
Si tu asistente no puede correr comandos
Los chats en la web, como Claude o ChatGPT, no tienen tu clave ni pueden llamar a la API desde ahí. Pídele que escriba el código y córrelo tú: «Que tu IA escriba el código».