El conector de Ninjō

0. Orientación

Si nunca conectaste nada a Claude, esta sección es la única obligatoria. El resto lo vas a poder leer salteado. Esta no.

Qué es Ninjō

Ninjō es la plataforma donde vive tu agente: el vendedor automático que atiende los mensajes que te llegan por Instagram y por WhatsApp. Contesta, califica, manda el link para agendar una llamada y avisa cuando alguien levanta la mano. Trabaja las veinticuatro horas y nunca se cansa de contestar la misma pregunta.

Cuando decimos la plataforma hablamos de la página donde entrás con tu usuario y tu contraseña: ahí conectás tus cuentas, mirás las conversaciones y prendés o apagás el agente. Todo lo que vas a leer acá pasa alrededor de esa plataforma. No la reemplaza.

Qué es el conector

Cuando decimos conector (su nombre técnico es MCP, y lo vas a ver escrito así en algunos lados) hablamos de la conexión que le das a Claude para que pueda leer y modificar los datos de tu cuenta de Ninjō.

El conector se activa una sola vez. Después queda prendido y te olvidás de que existe. A partir de ahí a Claude le hablás en castellano, como le hablarías a alguien del equipo. El paso a paso exacto para activarlo, con los links y los clicks reales, está en la sección 0.5, acá abajo.

Qué es un agente, y sus tres partes

Casi todo el mundo cree que un agente es un texto largo donde le explicás qué tiene que decir. Eso es un tercio del agente. Las otras dos partes son las que deciden si vende o si molesta.

La idea que ordena todo este documento

Todo lo que sigue está ordenado alrededor de esa idea. Los niveles 1, 2 y 3 son los datos y el texto. El nivel 4 es la automatización, y es donde está la plata.

Las dos formas de usar Claude con el conector

Hay dos, y no son la misma. Esta distinción define varias cosas más adelante, así que conviene entenderla ahora y no cuando algo no salga como esperabas.

Forma 1: Claude en la web o en la app de escritorio

Es el Claude que ya conocés: entrás a la página o abrís la app, escribís, te responde.

Qué puede hacer con el conector. Consultar todos tus datos de Ninjō en vivo: conversaciones, agendas, automatizaciones y embudo (las etapas por las que pasa un lead, de "recién llegó" a "agendó"). Y armarte un panel visual completo en el momento, con gráficos y tarjetas. A esa página que te arma la llamamos Artifact: es una página web que Claude genera y publica, con su propia dirección, privada por defecto, que podés compartir con tu equipo apretando un botón. Todo esto sin instalar nada. Dos minutos.

Qué se resuelve con la Forma 2. Guardar archivos en tu computadora y dejar el refresco programado se manejan desde Claude Code, que es lo que sigue acá abajo. Y hay un detalle que conviene conocer, porque es el que explica por qué existen las dos formas: cada vez que le pedís el panel en una conversación nueva, Claude te genera una dirección web nueva. El panel viejo queda congelado con los datos viejos. Por eso el que guardó el link en favoritos abre a la semana y ve números de la semana pasada. La Forma 2 es exactamente la que resuelve eso.

Para qué es ideal. La foto del momento. Reuniones, reportes a un cliente, "mostrame cómo venimos ahora". Es instantáneo y es compartible.

Forma 2: Claude Code, la versión que corre adentro de tu computadora

Es el mismo Claude, con el mismo conector, pero corriendo en tu máquina en vez de adentro de una página web. Se usa desde la terminal: esa ventana negra con texto donde se le escribe directo a la computadora.

Qué puede hacer, además de todo lo anterior:

• Guardar archivos en tu computadora. Tu panel deja de ser algo efímero y pasa a ser un archivo tuyo, que vive en una carpeta.
• Actualizar una página ya publicada sin cambiarle la dirección. Es la pieza que hace posible el "lo abro y está fresco".
• Dejar corriendo una tarea programada. Todas las mañanas a las 8:05, sin que vos hagas nada, Claude vuelve a consultar Ninjō y reescribe tu panel con los datos del día.

Para qué es ideal. El panel de operación. El que abrís todos los días y ya está actualizado.

La regla práctica

Claude Code se instala una sola vez y viene incluido en tu suscripción paga de Claude. La conexión con Ninjō, una vez que lo tenés abierto, es una sola palabra: /mcp. El paso a paso completo está en el Camino B de la sección 0.5, y si preferís no hacerlo solo, te lo dejamos andando en una llamada de quince minutos.

Glosario: los términos que van a aparecer sí o sí

Conector (MCP)

La conexión que le da a Claude acceso a tu cuenta de Ninjō. Las llaves de la oficina.

Agente

Tu vendedor automático. Vive en Ninjō y atiende los mensajes de Instagram y de WhatsApp.

El modelo

La inteligencia artificial que le piensa las respuestas al agente. Cuando decimos "el modelo" hablamos de eso. Cada vez que el modelo piensa una respuesta hay un costo, y por eso a veces conviene que ciertos mensajes salgan sin invocarlo (el saludo inicial, por ejemplo).

El evaluador

Un segundo cerebro de la plataforma, separado del agente que conversa. Lee las conversaciones y va completando la ficha del contacto: si agendó, si compró, en qué etapa está. El agente que conversa no puede escribir esa ficha. La escribe el evaluador. Es la pieza que explica las prácticas 7, 8, 9 y 11, que son las más caras de todas.

Las instrucciones

El texto donde le explicás al agente quién es y cómo habla. El manual del empleado. En la jerga se lo llama system prompt; en esta guía siempre le decimos "las instrucciones", para no confundirlo con el prompt que le escribís a Claude.

Prompt

El mensaje que le escribís a Claude. Nada más que eso. En esta guía, "prompt" significa siempre esto y nunca otra cosa.

Ejemplos

Conversaciones modelo. Pesan más que las reglas: si un ejemplo contradice una regla, gana el ejemplo.

El contenido del agente

El conjunto de archivos que le dan sustancia al agente: los ejemplos, las objeciones típicas, la base de conocimiento, la historia personal del cliente, el programa que vende, sus casos de éxito, las palabras clave. Su nombre técnico es v5Config, y así lo vas a ver escrito en las herramientas y en algunos prompts de esta guía.

Propiedad

Un dato que la plataforma guarda de cada contacto y que el evaluador va completando durante la conversación: "agendó" (sí o no), "compró" (sí o no), "en qué etapa está". Es la ficha del contacto.

Freno de contacto

La regla que hace que el agente deje de escribirle a alguien cuando pasa algo (agendó, compró, pidió hablar con una persona). Nombre técnico: contact limit.

Seguimiento automático

La rutina que le vuelve a escribir sola al lead que se quedó callado. Nombre técnico: follow-up o workflow. Las instrucciones nunca hacen seguimiento por sí solas.

Disparador

Lo que hace que el agente se active: una palabra clave en un mensaje, un comentario en un post, un click en un anuncio. Nombre técnico: trigger.

Embudo

Las etapas por las que pasa un lead, de "recién llegó" a "agendó". En Ninjō es una escala del 0 al 5, no un sí o no. Nombre técnico: funnel.

Publicar

Subir los cambios del agente para que empiecen a correr de verdad. Nombre técnico: deploy. Publicar no es terminar: mirá la práctica 16.

0.5. Cómo conectar

Esta es la llave. Diez minutos, una sola vez, y no la volvés a tocar. Todo lo demás de esta guía depende de este paso, así que hacelo antes de seguir leyendo.

Lo que necesitás antes de empezar

1. Tu cuenta en la plataforma de Ninjō. Si todavía no la tenés, el alta se hace desde app.ninjo.ai/signup. Vas a usar ese mismo mail y esa misma contraseña para conectar Claude, así que tenelos a mano.
2. Tu Instagram (o tu WhatsApp) vinculado desde la plataforma. Esto se hace una sola vez, adentro de Ninjō, porque requiere la autorización directa de Meta con tu usuario. Es un paso de seguridad y toma dos minutos. Está explicado en la sección 8, y es el único paso del onboarding que hace el cliente y no podés hacer vos por él.
3. Un plan pago de Claude (Pro, Max, Team o Enterprise). Es un requisito duro y no tiene vuelta: los conectores personalizados no existen en el plan gratuito, y Claude Code tampoco (necesita el mismo plan pago, o créditos de API, que se pagan aparte). No hay camino gratis, ni por el Camino A ni por el Camino B. Si preferís ChatGPT, ahí también hace falta un plan pago. Es el único costo fijo de todo esto, y es el precio de entrada a todo lo que sigue.

Qué camino elegís

Son los dos que ya viste en Las dos formas de usar Claude. La conexión es distinta en cada uno, y podés tener los dos prendidos a la vez sin ningún problema.

Si dudás, empezá por el Camino A. Es el más rápido, es el que usa la mayoría, y no te cierra ninguna puerta: el día que quieras el panel automático hacés el Camino B encima, y el conector es el mismo.

https://cortex-gateway.ninjoaiplatform.com/mcp

Cómo sabés que quedó

Escribile esto a Claude, tal cual:

Listame mis agentes.

Lo que tenés que ver: la lista de los agentes de tu cuenta, con sus nombres reales. Si sos agencia, vas a ver los de todos tus clientes. Eso significa que Claude está mirando tu cuenta de Ninjō de verdad, y ya podés hacer todo lo que sigue en esta guía.

Lo que significa si no lo ves. Si Claude te contesta con generalidades sobre Ninjō, o te dice que no tiene acceso, es que el conector no quedó activo en esa conversación. En el Camino A, revisá el paso 5 (prenderlo con el botón +) y la trampa de la dirección de arriba. En el Camino B, volvé a escribir /mcp.

Si algo de esto se traba, no pierdas tiempo: la sección 9 tiene el canal humano para escribirnos, y esto se destraba en minutos. Es el paso que más acompañamos y el que menos vale la pena sufrir solo.

Tu primera conversación con el conector

Ya estás conectado. En esta guía vas a encontrar catorce prompts (o sea, catorce mensajes) listos para copiar y pegarle a Claude. Varios son largos a propósito: adentro le decimos exactamente qué datos traer y qué hacer con ellos. No hace falta que los entiendas línea por línea. Hace falta que los pegues.

Este es el más corto, y es el que conviene correr primero, hoy mismo.

Conectate a Ninjō y hacé tres cosas, en este orden:

1. Decime sobre qué cuentas puedo operar con esta conexión, y cuál es el usuario de Instagram de cada una.
2. Listame los agentes de cada cuenta.
3. Corré un diagnóstico rápido de cada agente y explicame cada hallazgo en castellano, sin jerga: qué está faltando, qué me está costando eso en la práctica, y qué habría que hacer para arreglarlo.

Ordename los hallazgos por impacto en plata, no por gravedad técnica. Si no encontrás datos para algo, decímelo. No lo estimes.

En dos minutos vas a tener la primera radiografía de tu operación. Es probable que aparezca algo que no sabías. Casi siempre aparece.

La wiki oficial: el catálogo de lo que le podés pedir

0.75. Tu primer agente

Todo lo que sigue en esta guía sirve para medir, arreglar y automatizar un agente. Esta sección es la anterior a todas: cómo se escribe uno. No vas a tocar un archivo ni escribir código. Vas a tomar cuatro decisiones y contárselas a Claude.

La anatomía: las instrucciones más ocho secciones de contenido

Ya lo viste en la orientación: un agente es un texto de instrucciones más el contenido del agente. Ese contenido son ocho secciones concretas, y saber cuáles son te sirve para una sola cosa, pero es una cosa muy importante: distinguir un agente de verdad de un cascarón vacío.

Los cuatro arquetipos: la decisión la manda el precio

Esta no es una decisión técnica, es una decisión de negocio, y la tomás vos en treinta segundos. El precio de lo que vende tu cliente define qué tipo de agente le corresponde. Equivocarse acá es el error más caro del onboarding, porque un agente que cierra en el DM una oferta de cinco mil dólares no cierra nada, y un agente que empuja a una llamada de Zoom para vender un ebook de cuarenta y siete dólares espanta a todo el mundo.

Hay tres tipos más, que no son de venta pero resuelven problemas reales de tus clientes y son excelentes puertas de entrada para vos:

• Comunidad. Contesta con valor genuino y no vende nada. Para el cliente que está creciendo audiencia y quiere que cada seguidor se sienta visto.
• Lista de espera. Cortito. Captura interés antes de un lanzamiento, entrega el recurso, y mantiene al lead caliente hasta que abren las puertas.
• Soporte, con derivación a un humano. Contesta las mismas cinco preguntas de siempre y, cuando le preguntan algo que no sabe, escala con elegancia ("te paso con el equipo"). Al cliente que tiene el DM lleno de preguntas repetidas, esto solo ya le devuelve horas por semana.

Cómo se escribe una palabra clave (y por qué la mayoría no entrega)

Una palabra clave es el "mandame GUIA y te la paso" de toda la vida. Es la puerta de entrada más rentable que existe, y es también donde más plata se pierde en silencio. Esta es la forma canónica, la única que entrega:

{
  "keyword": "GUIA",
  "condition": "resource_with_flow",
  "video_url": "https://el-link-real-del-recurso",
  "literal_response": null,
  "match_type": "isolated_word",
  "send_without_permission": false
}

Traducido, línea por línea:

La condición (condition)

Es la línea que decide si el recurso se entrega o no. La plataforma reconoce exactamente tres valores, y ninguno más: literal_response (manda un texto fijo, escrito por vos), resource_with_flow (la plataforma se hace cargo de entregar el recurso adentro de un flujo de calificación: es la forma recomendada), y contextual (el agente decide en el momento qué contestar, sin entrega forzada).

Cómo tiene que coincidir (match_type)

isolated_word: solo se dispara si la palabra viene sola. Es para códigos y palabras-comando (así SAVE10 no se dispara con "quiero ahorrar plata"). any_mention: se dispara aunque venga adentro de una frase ("mandame la GUIA porfa"). Es para llamados a la acción naturales.

Entregar antes o después de calificar (send_without_permission)

En no, califica primero y entrega después. En sí, entrega al toque. Para un imán de leads, entregar al toque suele ser mejor: prometiste algo, cumplilo.

El link, metido adentro (video_url)

Poner la dirección del recurso adentro de la palabra clave hace que la entrega la maneje la plataforma. Si no está, la entrega depende de que el modelo se acuerde de ir a buscar el recurso por su cuenta, y ahí se equivoca de archivo o directamente dice "no tengo el link cargado". Es la diferencia entre entregar y prometer.

Clonar la voz del cliente: diez o veinte DMs reales, y nada más

Este es el paso que separa un agente que suena a tu cliente de uno que suena a chatbot, y cuesta cinco minutos de trabajo. No hace falta un documento de marca ni una guía de estilo. Hacen falta diez o veinte respuestas reales que el cliente haya escrito en su DM, copiadas y pegadas tal cual, con sus modismos, sus errores de tipeo y sus audios transcriptos si los tenés.

Pedile variedad, no solo lo lindo: cómo saluda, cómo maneja una objeción, cómo se entusiasma, y cómo le dice amablemente que no a alguien que no encaja. Ese último es el más valioso y es el que nadie manda.

Vamos a armar el agente de un cliente nuevo. Antes de escribir una sola línea, hacé esto:

1. Traé todo lo que ya tenemos de él con get_self_serve_data: su biografía de Instagram procesada, sus publicaciones con métricas, las conversaciones de ejemplo y el formulario que llenó al darse de alta. Decime qué falta y qué tenemos.

2. Mirá los agentes de ejemplo del manual (get_playbook_index) y decime cuál se parece más a este negocio.

3. Recomendame el ARQUETIPO según el precio de la oferta y explicame por qué:
   - menos de $100 → venta rápida
   - $100 a $1.000 → consultivo, cierra en el chat
   - más de $1.000 y compra emocional → premium que cierra en el DM
   - más de $1.000 y se cierra por Zoom → el que agenda llamadas
   Si el caso no encaja limpio en ninguno, decímelo en vez de forzarlo.

4. Acá van DMs reales del cliente, para que el agente suene a él y no a un robot:
[PEGÁ ACÁ 10 A 20 RESPUESTAS REALES SUYAS: saludos, objeciones, entusiasmo, y algún "no sos mi perfil" amable]

5. Escribime el agente COMPLETO, no un cascarón: instrucciones + ejemplos (10 o más, turno por turno) + base de conocimiento. Esas tres nunca van vacías. Más las palabras clave y el programa. Objeciones, historia personal, recursos y casos de éxito: completalas si aplican y decime cuáles dejaste vacías a propósito.

6. Las palabras clave, con la condición canónica: solo literal_response, resource_with_flow o contextual. Ninguna otra. Y metele la dirección del recurso adentro de la palabra clave, para que la entrega la maneje la plataforma y no dependa del modelo.

7. Mostrame todo ANTES de publicar nada. No lo prendas todavía: primero lo leo yo.

Cuando lo tengas escrito, todavía no lo prendas. Falta cablearle la automatización (el nivel 4) y falta verlo conversar (las conversaciones sintéticas). El orden completo, día por día, es la sección que sigue.

0.9. El onboarding de un cliente nuevo, día por día

"El cliente firmó el lunes." Esto es exactamente lo que hacés hasta que el agente está vivo. Todas las piezas ya estaban sueltas en esta guía: acá están ensambladas y en orden.

Día 1 (el mismo día que firma). La única tarea que no podés hacer por él

Hay un solo paso del onboarding que no podés hacer vos, y es la vinculación de la cuenta de Meta (Instagram o WhatsApp) desde la plataforma. Requiere que el cliente entre con su usuario de Facebook y autorice: es un paso de seguridad de Meta, toma dos minutos, y hasta que no esté hecho no hay agente que funcione.

Pedísela el mismo día que firma, y no la sueltes. Es la tarea que más onboardings hunde: no porque sea difícil, sino porque el cliente la posterga y el reloj de las 48 horas corre igual. Mandale el link y el paso a paso, y confirmá que quedó hecho antes de irte a dormir.

Todo lo demás del día 1 lo hacés vos, y no necesitás al cliente para nada.

Día 1. El brief, sin hacerle veinte preguntas

Nadie quiere llenar un formulario de treinta campos el día que firmó. Y no hace falta: el cliente ya cargó buena parte de esa información cuando se dio de alta. Está toda ahí, y se trae de una:

Traeme todo el onboarding de este cliente con get_self_serve_data: su biografía de Instagram ya procesada, sus publicaciones con métricas y transcripciones, las conversaciones de ejemplo y el formulario que llenó al darse de alta (qué programa vende, sus imanes de leads, su estilo).

Después decime dos cosas, separadas:
1. Lo que YA sabemos de él (y me alcanza para escribir el agente).
2. La lista corta de lo que falta DE VERDAD y solo él me puede dar. Máximo 5 preguntas, no veinte. Si algo lo podés inferir de sus posts o de sus DMs, inferilo y marcalo como inferido en vez de preguntármelo.

Con eso le mandás un mensaje corto con cinco preguntas y la vinculación de Meta, en vez de un formulario que no va a contestar. Es la diferencia entre arrancar el martes o arrancar la semana que viene.

Día 2. Escribir el agente

Es la sección anterior, entera: elegís el arquetipo según el precio, le pegás diez o veinte DMs reales del cliente para clonarle la voz, y le pedís a Claude el agente completo, con sus ejemplos y su base de conocimiento cargadas. Sin publicar.

Día 2. Cablear la automatización, antes de prender nada

Un agente con el texto perfecto y la automatización vacía le va a seguir escribiendo al que ya compró, y el cliente lo va a ver en la primera semana. Todo el cableado estándar se hace de una sola vez con el kit de activación (nivel 4): la propiedad de conversión del tipo correcto, el freno que hace callar al agente cuando el lead convierte, el seguimiento para los que no convirtieron, y el aviso al operador. Está entero en el caso 7.

Decidí acá una sola cosa, y es la única que Claude no puede adivinar: cuál es la conversión de este cliente. ¿Agendó? ¿Compró? ¿Dejó el teléfono? Ese es el hecho terminal del que cuelga todo lo demás.

Día 3. Cinco conversaciones sintéticas, leídas a mano

Antes de que lo vea un lead real, tenés que ver al agente conversar. Cinco conversaciones sintéticas, con tres perfiles distintos de lead, leídas por vos, una por una. No cincuenta con un puntaje promedio: cinco que leés. Está en el nivel 3 y la razón está en la práctica 17, que tiene el caso donde el puntaje daba 8,4 y el agente nunca mandaba el link.

Lo que buscás con los ojos: que el tono suene al cliente, que el link salga de verdad (no que lo prometa), que la palabra clave entregue el recurso, y que no se le escape el precio si no tiene que darlo.

Día 3 o 4. Salir por etapas, no de golpe

La tentación es prender todo el primer día. Es exactamente lo que rompe la confianza del cliente antes de que le muestres una sola llamada agendada, porque al agente le empiezan a llegar cosas que nunca estuvieron en el guion y el modelo improvisa delante de él.

Excepción legítima: una cuenta grande, con audiencia muy segmentada y un cliente que ya sabe lo que hace, puede ir directo a todos los mensajes. Es la excepción, no el default.

Día 4 (y todos los días de la primera semana). El diagnóstico post publicación

Publicar no es terminar. Que la publicación diga "verificado" significa una sola cosa: los mensajes están vivos. No significa que el sistema esté completo. El diagnóstico rápido es gratis, tarda treinta segundos, y te dice defecto por defecto qué te falta:

Diagnóstico diario del cliente nuevo. Tres cosas, en este orden:

1. diagnose_agent (mode: quick). Decime qué quedó sin cablear y el puntaje sobre 100.
2. Traeme las conversaciones reales de las últimas 24 horas (get_conversations, mode: recent) y leelas ENTERAS. Decime si el agente hizo algo raro, si entregó los recursos que prometió, y si el tono suena al cliente.
3. get_workflow_activity (days: 7): ¿mis automatizaciones dispararon de verdad, o están prendidas y en cero?

Cerrá con una sola línea: ¿el agente está sano, o hay algo que tengo que arreglar hoy?

Las herramientas, ordenadas por lo que querés lograr

El conector trae más de noventa herramientas. Nadie las necesita todas, y nadie las aprende de memoria. Están ordenadas acá en cinco niveles, y cada nivel es una cosa que querés lograr.

Nivel 1. Mirar

Antes de tocar una sola coma del agente, mirá las conversaciones reales. Es la base de todo, es gratis, y es lo que casi nadie hace.

La razón es incómoda: casi todo el mundo lee las conversaciones buenas, que dan orgullo, y las que le reporta un cliente enojado. Las del medio, las que se trabaron en silencio, no las ve nadie. Y ahí está el 80% de la mejora.

Nivel 2. Medir

La diferencia entre un agente que "anda" y uno que vende. Acá vive la palanca más subestimada del conector: una herramienta que audita el agente entero y te dice, defecto por defecto, con qué se arregla cada cosa.

Nivel 3. Mejorar

Cambiar lo que el agente dice, cambiar por dónde entra la gente, y probarlo antes de que lo vea un cliente.

Recordá el marco: todo lo de este nivel controla los mensajes del agente. Nada más que los mensajes. Lo que pasa alrededor está en el nivel 4.

Leer y publicar

Ajustar cómo se comporta

La prueba A contra B, y el enrutador

Es la única forma de decidir con datos en vez de con corazonadas, y es una palanca de crecimiento directa: cuando encontrás la versión que agenda más, ese porcentaje se lo llevás a todos los clientes del mismo rubro. Hoy casi nadie la usa, y es de lo más rentable que hay en esta guía.

Quiero probar dos versiones del agente y decidir con datos, no con intuición.

1. Traé la configuración actual (get_agent_config). Esa es la versión A.
2. Creá la versión B cambiando UNA SOLA COSA (te digo cuál: la apertura / el momento en que manda el link / cómo maneja la objeción de precio). Una sola. Si cambiás dos, después no sé cuál de las dos ganó.
3. Armá la prueba A contra B con update_agent_mode (mode: A_B_WORKFLOW), repartiendo 50 y 50.
4. Checklist del armado, verificalo y decime cómo quedó cada punto:
   - Los disparadores (palabras clave) y los audios van en el PADRE, que es el que recibe el DM. Las versiones hijas no llevan disparadores propios.
   - La cuenta de Instagram se engancha al padre.
   - El interruptor de "fijar la conversación" va APAGADO en el padre y PRENDIDO en los hijos. Si no lo podés tocar desde el conector, decímelo explícitamente para que lo revise yo en la plataforma.
5. Decime cuántos leads necesito para que la diferencia signifique algo, y avisame cuándo tengo suficiente. No me dejes declarar un ganador con 8 conversaciones.

Cuando la prueba tenga volumen, comparame las dos versiones por TASA DE AGENDA (no por cantidad de conversaciones ni por puntaje de calidad) y decime cuál gana y con qué margen.

Por dónde entra la gente: palabras clave, comentarios y anuncios

Los disparadores son la puerta de entrada. Definen qué hace que el agente se active: una palabra en un mensaje directo, un comentario en un post, un click en un anuncio, una respuesta a una historia.

Audio y voz: la palanca más subutilizada de todas

Un audio de la voz real del cliente, adentro del DM, hace algo que ningún texto hace: convierte al agente en una persona. Es lo que más levanta la conversión y lo que menos gente configura, porque está repartido en tres mecanismos distintos y nadie los tiene juntos. Acá están juntos.

Los dos audios que existen, y no son lo mismo

Los dos conviven, y lo normal es tener los dos: el grabado para los momentos que importan, la voz para el resto.

El paso que nadie hace: probar el agente antes de publicarlo

Bonus: el manual está adentro del conector

Ninjō publica su manual operativo dentro del propio conector. No dependés de que te lo mandemos por mail: le preguntás a Claude y él lo lee de la versión oficial, siempre actualizada. Adentro hay una librería de patrones que funcionan, una guía de errores típicos, los perfiles de indicadores clave, plantillas de instrucciones por tipo de venta, y cuatro agentes de ejemplo completos, con todo su contenido, para copiar y adaptar.

Nivel 4. Automatizar

Esta es la mitad del trabajo que casi nadie hace, y es donde está el 80% del valor.

Las instrucciones controlan los mensajes. Esto controla lo que pasa alrededor de los mensajes: que el agente deje de escribirle al que ya compró, que te avise cuando alguien agenda, que reenganche al que se enfrió.

Las propiedades

El freno

El seguimiento y los avisos

WhatsApp: escribir primero, con plata de Meta de por medio

Sacar leads de Instagram y llevarlos a WhatsApp, o escribirle a alguien que se enfrió. Es la parte más potente y la más fácil de romper, porque acá Meta cobra y Meta rechaza.

Otras palancas que casi nadie prende

Seis capacidades que no entran en ninguna de las cajas de arriba, que resuelven problemas concretos de tus clientes, y que se piden en una línea.

Nivel 5. Escalar

Si sos agencia y tenés varios clientes bajo tu cuenta, el conector está pensado exactamente para eso. Esta es la sección que más plata te ahorra por hora leída.

La rutina de agencia: tres cosas, y las tres son automáticas

Todo lo de arriba son herramientas sueltas. Esto es cómo se operan quince clientes sin morir en el intento, y es literalmente cómo lo hace el equipo de Ninjō puertas adentro.

1. La auditoría diaria de toda la cartera

Una vez por día, Claude barre todos tus clientes, revisa cada agente, te marca lo que se rompió y te lo prioriza. La diferencia con no hacerlo no es de comodidad: es que te enterás de un problema el mismo día y no a fin de mes, cuando el cliente ya decidió que esto no le sirve.

Auditá TODA mi cartera y mandame los flags de hoy, ordenados por urgencia.

1. get_agent_metrics (days: 7) SIN influencer_id. Con una conexión de agencia eso te devuelve una fila por cliente en una sola llamada. No hagas un loop cliente por cliente.
2. Marcá a los que tengan risk_score_0_100 alto, o mucha conversación de baja calidad, o una caída fuerte de volumen contra la semana anterior.
3. Para cada uno de los marcados, corré diagnose_agent (mode: quick) y decime en UNA línea cuál es el problema concreto y qué herramienta lo arregla.
4. Para todos, chequeá get_workflow_activity (days: 7): cualquier automatización configurada que NO disparó ni una vez es una red de seguridad que no existe. Marcala en rojo.

Cerrá con: "hoy atacá estos 3, en este orden, por esta razón". Si un cliente está sano, no lo menciones: quiero la lista de lo que requiere acción, no un informe de todo.

Y después dejala corriendo sola. Este mismo prompt, adentro de Claude Code, se programa igual que el panel del caso 5: corre todas las mañanas a las 8, y te deja los flags escritos antes de que abras la computadora. Pedíselo así: "dejame esta auditoría programada todas las mañanas a las 8, y que me deje el resultado en un archivo".

2. Un reporte automático por cliente, programado

El reporte mensual que hoy armás a mano, cliente por cliente, y que te come el primer lunes de cada mes. Se arma una vez y llega solo.

Quiero el reporte semanal de cada uno de mis clientes, armado una vez y programado para siempre.

Para CADA cliente de mi cartera (get_me te da la lista):
- get_agent_insights (days: 7): volumen, embudo por etapa con la conversión entre etapas, rendimiento por origen, y objeciones.
- get_agent_metrics (days: 7) acotado a ese cliente: tasa de envío del link y llamadas agendadas.
- La comparación contra la semana anterior, con la variación.
- Los leads calientes sin agendar (search_conversations, min_funnel 4, call_booked false): la plata que quedó sobre la mesa esta semana.

Armá UN archivo HTML por cliente, autocontenido, con los datos horneados adentro, listo para mandárselo. Con el nombre del cliente arriba y la fecha de generación bien visible.

Reglas:
- Si un dato no viene, va como "sin datos". No estimes ni un número: esto lo ve el cliente.
- Los nombres de las objeciones, en castellano: plata, confianza, momento, prioridad, sin identificar.
- Cerrá cada reporte con una sección de "qué hacemos esta semana": 2 o 3 acciones concretas, no un resumen.

Después dejámelo programado para que corra solo todos los lunes a las 8 de la mañana, y decime exactamente qué creaste y cómo lo apago.

3. Replicar el agente que mejor anda, de un cliente a otro

Esta es la palanca que nadie usa y la que más plata te hace. Cuando un agente funciona en un cliente, eso que funciona es un activo tuyo, y una sola conexión te deja leerlo de un cliente y publicarlo en otro. El trabajo de tres días de onboarding se convierte en el trabajo de una tarde.

Quiero replicar en un cliente lo que ya me está funcionando en otro.

Paso 1. Elegí el ganador con datos, no con mi intuición: get_agent_metrics (days: 30) sin influencer_id, y decime cuál de mis clientes tiene la mejor tasa de agenda. Ese es el modelo.

Paso 2. Leé su configuración completa (get_agent_config del cliente ganador): instrucciones, ejemplos, objeciones, base de conocimiento, palabras clave, programa.

Paso 3. Decime en 5 puntos QUÉ es lo que lo hace ganar. Concreto: en qué momento manda el link, cómo abre, cómo maneja la objeción de precio, cuántos ejemplos tiene, cómo califica. Eso es lo que vamos a replicar.

Paso 4. Leé la configuración del cliente destino y traé su contexto (get_self_serve_data). Después escribime su agente nuevo tomando la ESTRUCTURA del ganador, pero con:
- el programa, el precio y los links del cliente destino
- la voz del cliente destino (te paso sus DMs reales)
- sus palabras clave, no las del otro

NO copies el contenido del ganador tal cual. Si copiás sus casos de éxito o su historia personal a otro cliente, eso es una mentira que el lead va a descubrir.

Paso 5. Antes de publicar: mostrame el diff conceptual (qué me traje del ganador y qué es propio del destino), corré 5 conversaciones sintéticas y las leo yo. Recién después publicamos.

Paso 6. Cableale la automatización con scaffold_agent_activation, igual que al ganador. Un agente replicado sin frenos ni avisos es un agente a medias.

Una advertencia que vale la relación con el cliente: lo que se replica es la estructura (el flujo, el timing, el manejo de objeciones), nunca el contenido. Los casos de éxito, la historia personal y los testimonios son de cada cliente. Copiarlos de uno a otro no es un atajo, es una mentira, y se descubre en la primera llamada.

5.5. La capa de negocio: en qué orden se gana plata

Todo lo anterior es qué podés hacer. Esta sección es en qué orden, que es la pregunta que separa a la agencia que crece de la que se pasa el mes apagando incendios. Es corta a propósito. Leela dos veces.

Los tres focos, y el error es mezclarlos

Todo hallazgo sobre un agente cae en uno de estos tres cajones. Clasificarlo antes de actuar es lo que te saca del modo bombero:

La regla de oro de los tres, y es una sola: un cambio por vez, medir, y deshacer si empeoró. Cambiar tres cosas juntas y ver que el número subió no te enseña nada, porque no sabés cuál de las tres lo movió. Y la próxima vez vas a repetir las tres, incluida la que no servía.

Qué es un buen lead (y qué no)

El sistema te da un puntaje interno de cada lead. Es útil para ordenar una lista y para nada más. Un buen lead no es el que tiene puntaje alto.

La consecuencia práctica es incómoda pero simple: tenés que preguntarle al cliente. Una vez por semana, dos minutos: "de los que agendaron, ¿cuáles eran buenos?". Esa respuesta es la que te dice si el agente está calificando bien o si está llenando el calendario de gente que no compra, que es la forma más rápida de perder un cliente mientras le mostrás métricas verdes.

La palabra clave que gana no es la que más suena

Es la que mejor convierte, y casi nunca es la misma. La palabra clave de más volumen te llena el DM de curiosos y te infla las métricas de vanidad. La que mejor convierte suele traer menos gente, y traer a la que paga.

Esto no es una opinión, es medible, y está en el caso 12: cruzás las palabras clave contra la lista de compradores del cliente y te queda cada una clasificada en motor (mucho volumen y mucha plata: sostenela), joya (poco volumen pero ticket alto: acá está la oportunidad, hacé más contenido de este) y ruido (mucho volumen y nada de plata: te está inflando la cuenta de mensajes y no devuelve nada).

En un caso real: la palabra clave más popular era el motor, con unos $16.900 en 29 compradores. Pero la joya era otra, de nicho, con unos $11.700 en apenas 8 compradores y el ticket promedio más alto de todos. Y una tercera generaba miles de disparos y $125 de facturación. Ese solo dato le cambió el plan de contenido al cliente para todo el trimestre, y es un análisis de veinte minutos.

6. Las 18 prácticas que separan un agente que anda de uno que vende

Están ordenadas por lo que más plata cuesta. Cada una tiene la regla, el mecanismo (por qué es así y no de otra forma) y un ejemplo de mal contra bien. Ninguna es teórica: todas salen de agentes que se rompieron en producción.

7. Los casos, con el prompt listo para copiar

Esta es la parte que se usa. Cada caso arranca con el problema real, sigue con el prompt entero para pegar en Claude, y cierra con lo que vas a obtener y por qué sabemos que funciona.

Los prompts nombran las herramientas por su nombre técnico a propósito: es la forma más precisa de pedirle algo a Claude, y así no adivina. Ya las conocés todas por su nombre en castellano de las secciones anteriores.

Corré diagnose_agent (mode: quick) sobre mi agente y explicame cada hallazgo en castellano, sin jerga.

Por cada hallazgo quiero:
1. Qué está roto o faltando, en criollo.
2. Qué me está costando eso en la práctica (ejemplo: "el agente le sigue escribiendo a gente que ya te compró").
3. La herramienta exacta que lo arregla.
4. Si conviene arreglarlo o no. Recomendame vos, con criterio.

Dame el puntaje sobre 100 y ordename los hallazgos por impacto real en plata, no por gravedad técnica.

Después de eso, si el puntaje es bajo, corré diagnose_agent (mode: full) para que además audite las conversaciones reales y las instrucciones publicadas. Avisame antes de correrlo, porque ese modo tiene un costo: hace pensar a la inteligencia artificial sobre muchas conversaciones reales.

Traeme lo peor de mi agente, sin filtro, y decime qué arreglar.

1. get_conversations (mode: "stuck", limit: 10). Son conversaciones donde el agente mandó 6 o más mensajes y el lead nunca pasó de la etapa 3 del embudo. O sea: el agente habló al pedo.
2. get_conversations (mode: "bad", limit: 10). Son conversaciones que llegaron a etapa 4 o más pero con puntaje de calidad 3 o menos. O sea: el agente mandó el link a gente que no calificaba.
3. get_conversations (mode: "low-happy", limit: 10). Las conversaciones que fluyeron peor.

Leé las conversaciones completas, no el resumen de arriba.

Después decime:
- Los 3 patrones de falla que más se repiten, con una cita textual de cada uno.
- Para cada patrón: se arregla con un EJEMPLO nuevo, con una propiedad, o con una automatización? No me digas "agregá una regla a las instrucciones": el comportamiento va en ejemplos, no en reglas en prosa.
- Cuál de los 3 me está costando más plata.

Quiero el mapa de objeciones de mi agente.

Corré get_agent_insights (days: 30, sections: [objections, funnel]). La sección de objeciones agrupa los leads estancados (etapa 1 a 3, callados hace más de 72 horas) por tipo: MONEY, TRUST, TIMING, PRIORITY o UNKNOWN.

Ojo: necesita una ventana de al menos 4 días, porque un lead recién cuenta como estancado tras 72 horas de silencio. Y si me devuelve vacío es porque no tengo las propiedades de objeción configuradas: en ese caso decímelo y proponeme cuáles crear, con el prompt para crearlas.

Con el resultado:
1. Ordename las objeciones por volumen y decime cuál me está costando más.
2. Traé 3 conversaciones reales de la objeción más grande (search_conversations, min_funnel: 1, max_funnel: 3) y leelas enteras.
3. Decime si la objeción es REAL (el producto no encaja) o si es un problema del agente (la maneja mal, la levanta antes de tiempo, no la trabaja).
4. Si es del agente: escribime el ejemplo nuevo para el archivo de objeciones. Ejemplo concreto, con el diálogo, no una regla en prosa.
5. Si el bloque UNKNOWN es grande, alarmame: significa que el agente ni siquiera está detectando por qué se le caen.

Armame un panel visual del embudo de mi agente de los últimos 30 días.

Datos:
- get_agent_metrics (days: 30) para los indicadores agregados.
- get_agent_insights (days: 30) para el embudo por etapa y la conversión por origen de contenido.

Etapas que quiero ver:
- conversaciones (total)
- calificado (etapa 2 o más)
- link de agenda enviado
- agendó

Armalo como Artifact autocontenido: tarjetas de indicadores arriba, barras del embudo en el medio, tabla de conversión por origen abajo. Que se vea bien en el celular.

Dos cosas importantes:
1. Aclará adentro del panel qué denominador estás usando en la tasa de agenda. "Llamadas agendadas sobre leads" y "llamadas agendadas sobre links enviados" son dos números distintos. Decime cuál mostrás.
2. Si una herramienta no devuelve un dato, dejalo vacío y decilo. No lo rellenes con una estimación.

Quiero un panel de control visual de mi operación en Ninjō. Tiene que ser real (datos traídos del conector, cero invención), tiene que ser lindo, y después tiene que quedar actualizándose solo.

Trabajá en tres partes. No saltees ninguna y no me preguntes nada hasta terminar la Parte 1.

═══════════════════════════════════════
PARTE 1 - TRAER LOS DATOS REALES
═══════════════════════════════════════

Usá únicamente las herramientas del conector de Ninjō. Regla innegociable: si un dato no viene, se muestra como "sin datos". No estimes, no completes, no inventes un solo número.

1. Empezá con `get_me`. Eso te dice a qué cuentas tengo acceso y el nombre de usuario de cada una. Si hay más de una cuenta, el panel las tiene que cubrir a todas, con un selector arriba para cambiar entre ellas.

2. Para cada cuenta, corré `list_agents` para saber qué agentes tiene.

3. Traé los datos del período. Ventana principal: 30 días. Traé también la ventana de 7 días para poder mostrar variación.

   a) `get_agent_insights` con days=30 y sections=["volume","funnel","sources","objections"]:
      - volume: conversaciones nuevas, leads calificados, links de agenda enviados, más la línea de las últimas 24 horas
      - funnel: las etapas configuradas de MI embudo. Usá los nombres de etapa que devuelve la herramienta, no inventes etapas genéricas. Traé la cantidad de conversaciones por etapa y el porcentaje de conversión entre etapas consecutivas
      - sources: rendimiento por origen (DM orgánico, respuesta a historia, título del anuncio)
      - objections: leads frenados agrupados por objeción (MONEY / TRUST / TIMING / PRIORITY / UNKNOWN)
      Repetí la llamada con days=7 para la comparación.
      IMPORTANTE: esta herramienta puede devolver una sección vacía con una entrada en `warnings`. Es un comportamiento previsto. Si pasa, esa sección va al panel como "sin datos" y el resto se muestra igual. NO abortes el trabajo por eso.

   b) `get_agent_metrics` con days=30 y min_leads=3, acotada a cada cuenta (pasá siempre influencer_id, no la llames sin filtro). De ahí sacá: leads, new_conversations, qualified_leads, avg_engagement_score, avg_funnel, avg_lead_score, bookings_sent, booking_send_rate, calls_booked, call_book_rate_total, avg_happy_path_score, avg_nurturing_score, risk_score_0_100.
      Si esta llamada falla o tarda demasiado, seguí adelante sin ella y anotalo en el pie del panel. No es bloqueante.

   c) Las listas que requieren acción mía:
      - Calientes sin agendar: `search_conversations` con min_funnel=4, call_booked=false, limit=25. Son los leads que llegaron lejos y no agendaron. Es la plata que está sobre la mesa.
      - Trabados: `get_conversations` con mode="stuck", limit=10. Son las conversaciones donde el agente mandó 6 mensajes o más y el embudo no avanzó.
      - Alta intención pero baja calidad: `get_conversations` con mode="bad", limit=10.

   d) `get_workflow_activity` con days=30, para saber cuántas veces dispararon mis automatizaciones. Cruzalo con `list_workflows` y `list_custom_notifications`. Esto me importa mucho: si hay una automatización configurada que NO disparó ni una sola vez en 30 días, quiero verla en rojo.

   e) `list_contact_limits`, para saber qué frenos tengo puestos y sobre qué condiciones.

   f) `search_contacts` con created_after = hace 30 días, para saber cuántos contactos nuevos entraron. Corré también con from_ads=true para separar cuántos vinieron de anuncios de Meta.

ANTES de escribir una sola línea de HTML: mostrame en pantalla, en texto plano, un resumen de todo lo que trajiste con los números crudos. Quiero revisarlo. Si algo se ve raro te lo digo y lo corregís antes de seguir.

═══════════════════════════════════════
PARTE 2 - EL PANEL
═══════════════════════════════════════

Armá UN solo archivo HTML autocontenido. Todo el CSS y el JS van adentro del archivo, y los datos van horneados adentro como un objeto de JavaScript. La página NO debe hacer ninguna llamada a internet: ni fuentes externas, ni librerías por CDN, ni imágenes remotas. Cero pedidos a servidores de afuera.

Estructura, de arriba hacia abajo:

1. ENCABEZADO
   Nombre de la cuenta (o el selector, si son varias), la ventana de tiempo usada, y bien visible la fecha y hora de la última actualización. Ese sello es lo que me dice de un vistazo si el panel está fresco. Que se lea.

2. FILA DE INDICADORES PRINCIPALES
   Tarjetas grandes: número grande arriba, etiqueta abajo, y la variación contra los 7 días previos con flecha y color.
   - Conversaciones nuevas
   - Leads calificados
   - Links de agenda enviados
   - Llamadas agendadas
   - Tasa de agenda (llamadas agendadas sobre leads)

3. EMBUDO
   Barras horizontales, una por etapa, con el nombre real de MI etapa, la cantidad de gente, y entre etapa y etapa el porcentaje que pasó. Quiero ver de un vistazo dónde se me cae la gente.

4. REQUIERE ATENCIÓN
   Es la sección más importante. Si hay items, va arriba de todo lo demás.
   Lista accionable con los leads calientes sin agendar y las conversaciones trabadas. Por cada uno: usuario, última etapa que alcanzó, días de silencio, y un extracto del último mensaje. Ordenados por urgencia (más caliente y más silencioso, primero).

5. ORIGEN
   Tabla por fuente (DM orgánico, respuesta a historia, anuncio) con volumen y conversión. Marcá visualmente cuál convierte mejor.

6. OBJECIONES
   Los leads frenados, agrupados por motivo, con el conteo de cada grupo. Si esta sección no vino del conector, mostrala en gris con la leyenda "sin datos".
   Mostrá los nombres de las objeciones EN CASTELLANO: plata, confianza, momento, prioridad, sin identificar. El panel lo va a ver un cliente.

7. AUTOMATIZACIONES
   Tabla con cada seguimiento y cada notificación que tengo configurada, cuántas veces disparó en 30 días, y un semáforo:
   - verde: dispara con normalidad
   - ámbar: dispara poco
   - rojo: está configurada y NUNCA disparó
   Abajo de la tabla, listá los frenos de contacto activos.

8. PIE
   Hora de generación, ventana usada, y una línea honesta con las secciones que no se pudieron traer, si hubo alguna.

Reglas de diseño:
- Que se vea profesional y sobrio. No quiero un dashboard de plantilla genérica. Elegí una paleta con criterio y sostenela.
- Tiene que verse bien en tema claro y en tema oscuro. Definí los colores como variables CSS en :root, redefinilas dentro de @media (prefers-color-scheme: dark), y también en :root[data-theme="dark"] y :root[data-theme="light"] para que el interruptor de tema gane en las dos direcciones.
- Responsive de verdad: en el celular las tarjetas se apilan y las tablas anchas scrollean dentro de su propio contenedor, nunca la página entera de costado.
- Los números que van en columna llevan font-variant-numeric: tabular-nums, así quedan alineados.
- El color del semáforo (verde, ámbar, rojo) es información, no decoración. No lo uses para nada más.
- Nada de emojis como íconos de sección.

Guardá el archivo en una carpeta fija de mi computadora, creándola si no existe: ~/Panel-Ninjo/index.html

Después publicalo con la herramienta Artifact, para que yo tenga una dirección web fija que pueda abrir y compartir. Cuando lo publiques, decime la URL y guardala también en ~/Panel-Ninjo/URL.txt. La vas a necesitar en la Parte 3.

═══════════════════════════════════════
PARTE 3 - QUE SE ACTUALICE SOLO
═══════════════════════════════════════

(Si estoy usando Claude en la web o en la app de escritorio, ignorá esta parte entera: no aplica ahí. Aplica solo en Claude Code.)

Dos cosas que ya sabemos y que tenés que respetar al pie de la letra:

- Una corrida automática de Claude en segundo plano SÍ puede consultar el conector de Ninjō y SÍ puede reescribir el archivo HTML. Lo que NO puede es publicar Artifacts. Así que el script de refresco NO debe intentar usar la herramienta Artifact. Solo regenera el archivo ~/Panel-Ninjo/index.html.
- Por lo tanto, la corrida programada mantiene el archivo local siempre fresco. Si además quiero que una dirección de internet se actualice sola, eso se resuelve por la vía de publicación del punto 4.B de abajo.

Hacé lo siguiente:

1. Escribí la rutina de actualización (el script) en ~/Panel-Ninjo/refrescar.sh. Que corra Claude en modo no interactivo, o sea sin nadie adelante para contestarle, con las herramientas permitidas declaradas explícitamente, para que nunca se quede esperando un permiso que nadie va a dar. Adentro va un prompt autocontenido que rehaga exactamente la Parte 1 y la Parte 2 de este mensaje, sin el paso de Artifact, y sobrescriba ~/Panel-Ninjo/index.html. Que cada corrida deje registro en ~/Panel-Ninjo/refresco.log.

2. Corré ese script UNA VEZ a mano, ahora, delante mío. Mostrame que el archivo se regeneró y que el sello de "última actualización" cambió. Si no funciona, arreglalo antes de avanzar. No me digas que quedó listo sin haberlo probado.

3. Programalo con el programador de tareas de mi sistema operativo, de forma que sobreviva a un reinicio, para que corra todos los días a las 8:05 de la mañana. Decime exactamente qué creaste y cómo lo apago el día que quiera apagarlo.

4. Preguntame cuál de estas dos opciones quiero, y hacé la que elija:

   A. ME ALCANZA CON ABRIRLO YO. Dejame un acceso directo en el escritorio que abra ~/Panel-Ninjo/index.html. Se actualiza solo todas las mañanas mientras mi computadora esté encendida. No creo ninguna cuenta nueva.

   B. QUIERO UNA DIRECCIÓN QUE VEA TODO MI EQUIPO. Publicá el panel en un servicio gratuito que hospede páginas web, y agregá a la rutina de actualización el paso de publicación, así la dirección se actualiza sola todas las mañanas. Decime cuál servicio usar, explicame en criollo qué cuenta gratuita tengo que crear y guiame apretando botones. Nada de tarjeta de crédito.

Cerrá con un resumen de tres líneas: dónde está mi panel, a qué hora se actualiza, y cómo lo apago.

Quiero recuperar los leads que se me escaparon. Buscame los que YA recibieron el link de agenda y nunca agendaron.

1. search_conversations con: has_booking_link: true, call_booked: false, last_message_before: (hace 7 días), limit: 100. Paginá si hay más de una página.
2. Ordenámelos por lead_score descendente y por funnel descendente: primero los más calientes.
3. Para los top 20, leé la conversación y decime en una línea por qué se cayó cada uno (no vio el link, dijo que lo iba a ver, objeción de plata, se fue en silencio).
4. Agrupalos por motivo de caída.

Después, la parte importante: no quiero recuperarlos a mano nunca más. Armame la automatización para que esto no vuelva a pasar.
- Un seguimiento automático (upsert_workflow, type FOLLOW_UP) condicionado a booking_link_sent = true Y call_booked distinto de true, con minMinutesSinceLastInbound para que solo toque a los que están callados hace rato.
- Mostrame la condición exacta ANTES de crearla y esperá mi OK.

Acordate: condicionar siempre sobre propiedades de sí o no, nunca sobre texto.

Quiero convertir mi agente de un texto suelto a un sistema de producción.

Paso 1. Corré diagnose_agent (mode: quick) y decime qué me falta del kit de activación.

Paso 2. Cableame el kit con scaffold_agent_activation. Mi propiedad de conversión es: (call_booked / purchased / la que use). Quiero:
- terminal_property: esa, garantizada como propiedad de sí o no (nunca de texto: el texto compara mal).
- Un freno de contacto prendido y condicionado a esa propiedad, para que el agente DEJE DE ESCRIBIRLE al que ya convirtió.
- followup: un seguimiento automático condicionado a NO convertido, con interval_minutes (recomendame vos el número), para reenganchar al que se enfrió. Nunca sin condición.
- notify: la notificación de conversión a mi destino de avisos.

Mostrame qué va a crear y qué va a reusar ANTES de ejecutarlo. La herramienta es segura de correr dos veces: si algo ya existe lo reusa en vez de duplicarlo.

Paso 3. Volvé a correr diagnose_agent (mode: quick) y mostrame el puntaje antes y después.

Paso 4. Verificá dos cosas que se olvidan siempre:
- Que la propiedad terminal tenga prendido el "seguir chequeando hasta que sea sí". Sin eso, se congela en "no" en el primer mensaje y el freno no dispara nunca.
- Que el freno de contacto NO tenga mensaje de cierre (el corte va en silencio, es deliberado), y que en cambio SÍ esté cableado el aviso al operador, para que el lead que convirtió no quede en el aire.

Quiero dejar de mirar el DM a mano. Armame el sistema de avisos.

Paso 1. Mostrame lo que ya tengo: list_notification_destinations, list_custom_notifications y list_workflows. Decime qué está prendido y qué no.

Paso 2. Si no tengo destino, creá uno con upsert_notification_destination. Quiero que me llegue a (elegí: Slack / email / Telegram / WhatsApp a mi número de operador). Los canales disponibles son EMAIL, SMS, WHATSAPP, WHATSAPP_TEMPLATE, TELEGRAM, SLACK y SNS.

REGLA CRÍTICA si elijo WHATSAPP_TEMPLATE: el campo `destination` es un teléfono OPCIONAL. Si lo completás con mi número, la plantilla me llega A MÍ (alerta interna). Si lo dejás vacío, la plantilla le llega AL LEAD. No lo confundas: un aviso interno con el campo vacío se lo mandás a un lead. El `level` (INFO / WARNING / ERROR / SUCCESS / MESSAGE) es solo una etiqueta de gravedad y NO decide el destinatario.

Paso 3. Creá la notificación de conversión con upsert_custom_notification (level: SUCCESS) y cableala con un workflow tipo CUSTOM_NOTIFICATION condicionado a mi propiedad de conversión (call_booked o purchased, la que use). Que el aviso me llegue con el nombre del lead y el link a la conversación.

Paso 4. Lo mismo pero para lo que se rompe: un aviso cuando el agente decide no responder, para que yo entre a esa conversación.

Mostrame la configuración de cada uno ANTES de crearlo y esperá mi OK.

Paso 5 (el que nadie hace). Con get_workflow_activity (days: 30) armame un panel que me muestre, por cada seguimiento y cada notificación: cuántas veces se evaluó, cuántas veces disparó de verdad, y la tasa. Quiero cazar las que están configuradas pero nunca dispararon. Esas son las peligrosas: creés que tenés una red de seguridad y no tenés nada.

Auditame todas las palabras clave del agente. Quiero saber cuáles no están entregando.

Una palabra clave vive en 3 lugares, y si falta en uno queda incompleta y no entrega:
1. Disparador de DM (trigger_keywords), que captura el match en mensajes directos.
2. Disparador de comentarios (trigger_comments), si entra por comentario en un post o reel.
3. El contenido del agente (v5Config, sección keywords), que define la condición de entrega y el recurso.

Proceso:
- list_triggers (agent_id) para ver qué existe en plataforma.
- get_agent_config (agent_id) para ver las keywords del contenido del agente.
- Cruzá las dos listas y decime: qué palabra clave está en plataforma pero NO en el contenido (el disparador captura al lead y el agente no sabe qué hacer, cae a flujo genérico), y cuál está en el contenido pero NO en plataforma (el agente sabría responder pero nunca la capturan).

Después chequeá las CONDICIONES. Las únicas 3 válidas son: literal_response, resource_with_flow y contextual. Si ves cualquier otra cosa, esa palabra clave no está entregando el recurso. Listámelas.

Por último, para las que entregan un recurso: verificá que la forma de coincidencia del contenido coincida con la de la plataforma (palabra aislada con palabra aislada, en cualquier parte con en cualquier parte).

Dame una tabla: palabra clave, estado (OK / falta en plataforma / falta en contenido / condición inválida / coincidencia desalineada), y el arreglo concreto de cada una.

Quiero saber qué anuncio de Meta me trae los leads que realmente convierten.

1. search_contacts (from_ads: true, created_after: hace 30 días, limit: 100, paginá). Eso trae solo los contactos que llegaron por un anuncio, y cada uno viene con la ficha del anuncio que lo trajo la primera vez: nombre del anuncio, publicación e identificador (referral_ad_id, ad_title, post_url).
2. Agrupá los contactos por anuncio.
3. Para cada grupo, traé sus conversaciones con search_conversations y calculá: cuántos llegaron a etapa 2 o más (calificado), cuántos recibieron el link (has_booking_link), cuántos agendaron (call_booked).
4. Si te paso mi lista de compradores, cruzá también facturación por anuncio.

Dame la tabla ordenada por tasa de conversión, no por volumen de leads. Y decime explícitamente: qué anuncio pausar, cuál escalar, y por qué.

Comparalo contra los contactos que NO vienen de anuncios (search_contacts con from_ads: false): el tráfico orgánico convierte mejor o peor que el pago?

Te paso mi lista de compradores del mes (una planilla con nombre, email, usuario de Instagram, teléfono y monto pagado). Quiero un reporte de atribución de ventas del agente.

Proceso:
1. Consolidá y deduplicá los compradores por email. Decime total facturado y cantidad de compradores.
2. Para cada comprador, buscalo en mis contactos con search_contacts (probá por email, después por instagram_username, después por phone).
3. Para los que matchean, traé su conversación con search_conversations (contact_username) y fijate si el agente le habló DE VERDAD. Criterio mínimo: 5 mensajes del agente (min_agent_messages: 5) y que el primer contacto del agente sea ANTERIOR a la fecha de compra.
4. Clasificá a cada comprador en 3 niveles: (a) agendó llamada vía el agente, (b) conversó con el agente y compró sin agendar, (c) sin contacto con el agente.
5. Dame el total en $ de cada nivel, el % de la facturación del mes, y la tabla de los 10 compradores más grandes con su nivel.

Reglas: no inventes ningún número. Si un comprador no matchea, va a "sin contacto", no lo fuerces. Al final decime explícitamente qué porcentaje de la facturación tocó el agente y con qué nivel de confianza.

Encuadre: el agente CALIFICA Y CALIENTA, el equipo humano cierra. No digas nunca "el agente cerró la venta". Decí "el agente trabajó al comprador".

Quiero cerrar el loop de atribución: que las compras del sitio de mi cliente vuelvan con el identificador del contacto de Ninjō, para no tener que cruzar planillas a mano.

CONTEXTO QUE YA ES VERDAD (no lo cambies, no hay que configurarlo):
La plataforma le inyecta sola el parámetro `utm_term=` a TODA dirección web que el agente comparta en el DM. El link de agenda, el link de pago, el link del recurso: todos salen marcados. No hace falta escribir nada en las instrucciones del agente.

LO QUE QUIERO QUE ME ARMES, para el sitio del cliente, con Google Tag Manager y Google Analytics:

1. Una variable que lea `utm_term` de la dirección de la página.
2. Una etiqueta que, en CUALQUIER página de entrada, si `utm_term` viene con valor, lo guarde en una cookie propia del sitio (dale 90 días de vida). Este paso es el que casi todos se saltean y es el que hace que funcione: el identificador llega en la página de aterrizaje, pero la compra se confirma en la página de gracias, y para entonces ya se perdió de la dirección.
3. Una variable que lea esa cookie.
4. En el evento de compra (la página de gracias, o el evento de compra de la plataforma de pago), que mande a Analytics ese identificador como parámetro propio, junto al monto y a la moneda.

Dame el paso a paso con los clicks exactos de Tag Manager, en castellano, asumiendo que NO programo. Si un paso necesita que alguien toque el sitio, decímelo por separado y bien claro, así se lo paso a quien corresponda.

Al final, decime cómo COMPRUEBO que quedó andando antes de cantar victoria: quiero entrar a una dirección de prueba con un utm_term inventado, comprar, y ver el identificador llegar a Analytics.

Te paso el export de Analytics de las compras de este mes. Cada fila trae el identificador del contacto (el que viajó en utm_term) y el monto.

1. Traeme mis contactos con search_contacts (paginá hasta traerlos todos): cada contacto viene con su contact_id.
2. Cruzá los identificadores del export contra esos contact_id. Es una unión EXACTA: no matchees por mail ni por usuario de Instagram, no hace falta y ahí es donde se cometen los errores.
3. Para cada comprador matcheado, traé su conversación (search_conversations) y decime: por qué palabra clave entró, cuántos mensajes tuvo con el agente, si agendó, y cuántos días pasaron entre el primer mensaje y la compra.

Dame:
- La facturación total atribuida al agente, con nombre y apellido de cada comprador.
- El desglose por palabra clave de entrada, con ticket promedio. Cuál es el MOTOR, cuál la JOYA y cuál el RUIDO.
- Los compradores que compraron SIN agendar nunca. Ese número siempre sorprende y es plata que la métrica de agendas esconde.
- Cuántas compras vinieron SIN identificador. Esos son los que nunca pasaron por el agente (entraron por un post orgánico, por un anuncio directo, por una historia). No los cuentes como fallas del tracking: son otro canal, y saber cuánto pesan también te sirve.

No estimes nada. Si una compra no matchea, va a "sin contacto con el agente".

Quiero inteligencia de contenido: qué palabra clave me trae los compradores más caros, no los más numerosos.

1. Traé mis disparadores con list_triggers (agent_id) para tener la lista real de palabras clave activas, por canal (DM, comentarios, historias, anuncios).
2. Con get_agent_insights (days: 30, sections: [sources, funnel]) traeme la conversión por origen de contenido.
3. Cruzá contra mi lista de compradores del mes (te la paso): para cada comprador matcheado, identificá con qué palabra clave entró (el primer mensaje entrante de su conversación, vía search_conversations).
4. Armame una tabla por palabra clave con: disparos totales, compradores, facturación total, y TICKET PROMEDIO (facturación dividida compradores).
5. Ordenala por ticket promedio, no por volumen.

Al final clasificá cada palabra clave en una de tres categorías y decime qué hago con cada una:
- MOTOR: mucho volumen y mucha plata. Sostenerla.
- JOYA: poco volumen pero ticket alto. Acá está la oportunidad: hacer más contenido de este.
- RUIDO: mucho volumen y poca plata. Está inflando la cuenta de mensajes sin traer facturación.

No inventes números: si una palabra clave no tiene compradores matcheados, decí 0. No estimes.

Soy una agencia y manejo varias sub-cuentas. Quiero el tablero de riesgo de TODA mi cartera.

Llamá a get_agent_metrics (days: 30) SIN pasar influencer_id. Con una conexión multi-cliente eso devuelve una fila por cada cliente que manejo, en una sola llamada. No hagas un loop de get_agent_insights cliente por cliente: es innecesario.

Con eso armame un panel con una tabla ordenada por risk_score_0_100 descendente (el más riesgoso arriba), y por cada cliente mostrame:
- leads y conversaciones nuevas
- avg_funnel y avg_lead_score
- booking_send_rate y call_book_rate_total
- pct_happy_lt_60 (conversaciones de baja calidad)
- risk_score_0_100

Pintá en rojo los que tengan riesgo alto o mucha conversación de baja calidad.

Después, para los 3 peores, corré diagnose_agent (mode: quick) y decime en una línea por cliente cuál es el problema concreto y cuál es la herramienta que lo arregla.

Cerrá con: "esta semana atacá estos 3, en este orden, por esta razón".

8. Qué se hace desde la plataforma y qué desde Claude

Ninjō es un producto con dos caras: la plataforma y el conector. Cada cosa vive en un lado, y no es arbitrario. Esta sección es el mapa, para que nunca te quedes sin saber por dónde va algo.

1. La vinculación con Instagram y WhatsApp

Se realiza desde la plataforma, porque requiere la autorización directa de Meta con el usuario del cliente: hay que entrar con la cuenta de Facebook, elegir el portafolio empresarial y confirmar. Es un paso de seguridad, y es el mismo que te pide cualquier herramienta seria que toque tus mensajes. Toma dos minutos.

Por dónde sí va desde Claude: una vez que la cuenta está vinculada, Claude la lista, la engancha al agente que vos quieras, y lee todos sus datos sin ningún límite. En el onboarding de un cliente nuevo, esta vinculación es la tarea del cliente, y conviene pedírsela el primer día, porque es el único paso que no podés hacer por él.

2. Las plantillas de WhatsApp

La plantilla se escribe y se manda a revisión en el Business Manager de Meta, y es Meta quien la aprueba. Es su regla, y aplica a todas las herramientas del mercado por igual.

Por dónde sí va desde Claude: una vez aprobada, toda la cadena que la usa se arma acá. Claude lista tus plantillas aprobadas, define los huecos que se completan con datos reales del contacto, crea el destino, crea el aviso y crea el seguimiento que la dispara sola cuando un lead cumple una condición. O sea: Meta aprueba el texto, y todo el mecanismo que lo hace útil lo cableás vos en cinco minutos.

3. La ventana de veinticuatro horas de WhatsApp

Por WhatsApp podés mandar texto libre solamente dentro de las veinticuatro horas del último mensaje que te mandó el lead. Es una regla de Meta, igual para todo el mercado, y se cumple igual en todas las plataformas.

Por dónde sí va: fuera de esa ventana, el mensaje sale como plantilla aprobada. Es exactamente para eso que existen las plantillas. Un recordatorio de llamada, un reenganche a un lead frío, un anuncio de promoción: todo eso funciona perfecto, y funciona solo, con la cadena del punto anterior. Lo único que hay que tener presente es que un seguimiento de texto libre fuera de la ventana no se entrega y no avisa, así que la regla práctica es: si vas a escribir primero, plantilla.

4. Calendly y otras integraciones externas

La conexión de Calendly, y la de cualquier integración externa, se hace desde la plataforma, en la sección de Integraciones. Lo mismo vale para las conexiones automáticas entre sistemas (por ejemplo, la que prende una propiedad cuando alguien agenda desde Calendly): se configuran una vez, desde la interfaz.

Qué pasa si tu cliente no tiene Calendly Pro. La integración automática de Calendly requiere el plan Pro, pero el agente funciona igual: puede entregar el link de agenda de la herramienta que use tu cliente (Cal.com, Google Calendar, TidyCal, la que sea) como un link común, y agendar igual. Lo único que se pierde sin la integración es que la propiedad "agendó" se prenda sola cuando la persona reserva. Y eso también tiene salida: el evaluador puede detectar el agendamiento leyendo la conversación (cuando el lead dice "listo, ya reservé"), y sobre esa propiedad cablear el freno y el aviso igual que siempre. Es un poco menos exacto que la integración, y alcanza perfectamente. Si querés la versión exacta sin Calendly Pro, escribinos y vemos qué integración de las soportadas le sirve a tu cliente.

Por dónde sí va desde Claude: todo lo que pasa después. Claude lee las agendas, arma los avisos, dispara el recordatorio, y mide la tasa de agenda por origen. La integración es un enchufe que se conecta una vez; lo que corre por el cable lo manejás desde acá.

5. Quién completa las propiedades del contacto

Las propiedades las completa un evaluador de la plataforma, que es un modelo separado que lee la conversación. El agente que conversa no las escribe, y por eso pedirle en las instrucciones "marcá al lead como calificado" no produce ningún efecto (práctica 9).

Por dónde sí va desde Claude: vos definís qué propiedades existen, de qué tipo son, y qué automatización cuelga de cada una. Eso es todo lo que hace falta. El evaluador se encarga de completarlas solo.

6. Los datos internos del motor

El costo por conversación, los registros internos del modelo y el texto exacto que el modelo vio en producción (que incluye un bloque de contexto del contacto que se inyecta en el momento) los ve el equipo de Ninjō, no el conector.

Por dónde sí va: para el 95% de los casos no los necesitás. Con las conversaciones reales, las métricas, los insights y el diagnóstico llegás al fondo de casi cualquier problema. Y cuando genuinamente hace falta mirar el motor por dentro, se lo pedís al equipo desde el propio Claude (herramienta de reporte, nivel 5): abre el ticket con todo el contexto ya cargado, sin que tengas que explicar nada dos veces.

7. Tres detalles de plataforma que conviene conocer

Los tres son comportamientos reales, medidos, y los tres tienen una forma concreta de detectarlos. Preferimos que los sepas vos antes de que te los cuente un cliente.

a) Un seguimiento condicionado a una propiedad vacía no dispara

Una propiedad de sí o no no se completa hasta que el evaluador la mira por primera vez. Hasta ese momento está vacía, que no es lo mismo que "no". Un seguimiento condicionado a "que sea igual a no" no encuentra a nadie, y se queda en cero disparos sin avisar. Afecta a los seguimientos y a los avisos, no a los frenos de contacto, que manejan bien el dato vacío.

Cómo lo detectás: la herramienta de actividad de automatizaciones. Si un seguimiento dice cero disparos en treinta días, es esto en la mayoría de los casos. Por dónde sí va: se condiciona con "distinto de sí" en vez de "igual a no", y el dato vacío pasa igual. Es un cambio de un minuto que Claude te hace en el momento.

b) Las conversaciones que esperan respuesta quedan afuera del seguimiento

Cuando el lead escribe y el agente todavía no contestó, la conversación queda marcada como "espera respuesta", y el motor de seguimientos la saltea. En las mediciones internas, el alcance recortado va de un 8% a un 59% según el agente.

Por dónde sí va: la lista del caso 6. Los leads calientes que quedan afuera del seguimiento automático se recuperan a mano una vez por semana, con el prompt que te deja la lista ordenada por urgencia. Y el panel del caso 5 los pone arriba de todo, en la sección "requiere atención". Es la razón por la que ese bloque existe.

c) Las respuestas a Reels por mensaje directo

Instagram entrega la respuesta a un Reel como un mensaje directo con la dirección del Reel adjunta como imagen. En agentes que atienden todos los mensajes y además tienen filtro de entrada y palabras clave de DM, el filtro evalúa esa imagen, la descarta, y la palabra clave no se registra. Un agente que no atiende todos los mensajes no está afectado.

Por dónde sí va: los comentarios con palabra clave en el Reel funcionan perfecto, así que un disparador de comentarios te suma una vía de entrada sólida para el mismo contenido. No recupera al que te respondió el Reel por mensaje directo (son dos vías de entrada distintas), pero cubre el grueso del tráfico de Reels. El arreglo de fondo ya está en el plan de mejoras de la plataforma, y si esto te está pasando conviene reportarlo desde Claude para que el equipo lo priorice con tu caso a la vista.

8. Funciones que se resuelven por otra vía

• Facturación, planes y gestión de usuarios: desde la plataforma y con tu contacto en Ninjō.
• Publicar y programar contenido en Instagram: seguí con la herramienta que ya usás (Meta Business Suite, que es gratis, o Metricool, Later, la que sea). Ninjō entra en juego en el momento en que ese contenido genera un mensaje. Y lo que sí hace, desde Claude, es leer tus publicaciones con sus métricas y cruzarlas contra los leads que trajo cada una, que es la parte que te sirve para decidir qué contenido hacer (caso 12).
• Generar imágenes: se hace con Claude directamente, fuera del conector, y una vez que tenés la imagen la cargás como recurso del agente en dos pasos (nivel 3).

9. Publicar no es terminar

9. Cómo destrabar cualquier cosa

Cuatro caminos, en este orden. Los tres primeros los corrés vos y resuelven casi todo. El cuarto es una persona.

1. Preguntale al manual. Está adentro del conector y siempre está actualizado. "Buscá en el manual de Ninjō cómo se hace X" resuelve más de lo que parece, y tarda diez segundos.
2. Corré el diagnóstico. Muchas de las cosas que se sienten como "el agente anda mal" son en realidad cableado faltante, y el diagnóstico las nombra una por una con su arreglo.
3. Reportalo desde Claude. "Esto no está funcionando como espero, reportáselo al equipo de Ninjō con todo el contexto." Abre el ticket con la información completa y le llega al equipo. Deja registro, y es el camino más rápido cuando el conector ya está andando.
4. Escribinos directamente. Por el canal de Slack compartido que tenés con Ninjō, o por WhatsApp a tu contacto de Ninjō. Es el camino para todo lo que pasa antes de tener el conector prendido, porque ahí el punto 3 todavía no te sirve.