Herramientas generales
Estado de la cuenta, resumen de campañas, informes, cola de aprobaciones, perfil de marca y herramientas de cambio independientes del canal.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura22 herramientas
get_status
Lectura1 créditosResumen de la cuenta: marca, plan, plataformas conectadas, campañas (7 días), aprobaciones pendientes, chats de clientes abiertos, guardián de gasto. Llámalo primero cuando el contexto sea desconocido.
Esta herramienta no recibe parámetros.
list_accounts
Lectura1 créditosCuentas de anuncios y de datos conectadas (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) con su estado. Las conexiones 'sample' son datos de demostración, no reales.
| Parámetro | Tipo | Descripción |
|---|---|---|
platformOpcional | string | optional filter, e.g. google, meta, microsoft |
all_accessibleOpcional | boolean | also name the tool that lists every accessible account of each platform |
list_campaigns
Lectura1 créditosCampañas con el gasto, los clics, los pedidos y los ingresos de los últimos N días. Usa los ids de campaña devueltos para update_campaign / add_negative_keywords.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–90) | — |
get_report
Lectura1 créditosInforme del período: gasto, pedidos, ingresos, ROAS, variación frente al período anterior, sugerencias. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
periodOpcional | day | week | month | — |
platformOpcional | string | all (default) | google | meta | microsoft | tiktok | linkedin | openai-ads | ga4 | search-console |
accountOpcional | string | account id on platforms that take one per call (microsoft, linkedin, openai-ads, ga4 property, search-console site) |
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
levelOpcional | string | campaign | ad_group | adset | ad | keyword | location | device | age_gender (what the platform supports) |
breakdownOpcional | string | platform breakdown, e.g. device, age, placement |
limitOpcional | integer (1–500) | — |
search_terms_report
Lectura2 créditosTérminos de búsqueda de Google Ads con gasto, clics y conversiones de los últimos N días, más los términos desperdiciados (sin conversiones). Requiere una cuenta de Google Ads conectada; de lo contrario devuelve una nota, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–90) | — |
campaign_idOpcional | string | — |
account_audit
Lectura3 créditosAuditoría de higiene de la cuenta como hallazgos priorizados: gasto sin resultados, presupuestos faltantes, sin límite de gasto, términos de búsqueda desperdiciados, aprobaciones pendientes. Solo lectura.
Esta herramienta no recibe parámetros.
list_pending_approvals
Lectura1 créditosCambios que esperan la aprobación del usuario (id, tipo, título).
Esta herramienta no recibe parámetros.
get_brand_profile
Lectura1 créditosBase de conocimiento de la marca: sector, ubicación, productos, audiencia, objetivos, tono, competidores.
Esta herramienta no recibe parámetros.
research
Lectura4 créditosInvestigación web (competidor, precio, normativa del sector). Si no hay un proveedor de investigación configurado, devuelve una nota; nunca inventa resultados.
| Parámetro | Tipo | Descripción |
|---|---|---|
queryObligatorio | string | — |
list_customers
Lectura1 créditosConversaciones de clientes en la bandeja de entrada (WhatsApp, Messenger, Instagram): quién escribió, último mensaje, en espera de respuesta.
| Parámetro | Tipo | Descripción |
|---|---|---|
stateOpcional | needs_you | waiting | auto | done | — |
limitOpcional | integer | — |
list_entities
Lectura1 créditosLista con sus id y paginadas las campañas, grupos / conjuntos de anuncios, anuncios o palabras clave de cualquier plataforma publicitaria conectada, en lugar de buscar la herramienta de listado específica (el resultado indica la herramienta de origen). Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
platformOpcional | string | google | meta | microsoft | tiktok | linkedin | openai-ads (vacío = campañas del registro de todas las plataformas) |
entityOpcional | campaigns | ad_groups | ads | keywords | — |
parent_idOpcional | string | id de campaña para grupos de anuncios, id de grupo de anuncios para anuncios/palabras clave (cuando la plataforma lo requiere) |
accountOpcional | string | id de cuenta en las plataformas que usan una por llamada |
daysOpcional | integer (1–90) | campañas del registro: cifras de los últimos N días |
limitOpcional | integer (1–500) | — |
offsetOpcional | integer (0–…) | — |
account_snapshot
Lectura1 créditosImagen de una cuenta publicitaria (o de todas) en una sola llamada: conexiones, número de campañas activas/en pausa, gasto reciente, pedidos, ingresos, ROAS por plataforma y campaña, aprobaciones pendientes y los últimos cambios aplicados. Úsalo antes de cualquier revisión. Solo lectura, sin llamadas externas.
| Parámetro | Tipo | Descripción |
|---|---|---|
platformOpcional | string | — |
accountOpcional | string | filtra las conexiones por id de cuenta |
recent_daysOpcional | integer (1–90) | — |
include_inactiveOpcional | boolean | lista también las campañas en pausa/finalizadas sin gasto |
get_billing_status
Lectura0 créditosPlan actual, estado de la cuenta, fecha de fin de la prueba y saldo de créditos (periodo, límite, usados, restantes, puestos).
Esta herramienta no recibe parámetros.
start_subscription
Lectura0 créditosDa al usuario el enlace del panel donde él mismo elige un plan de pago, acepta las condiciones legales y paga en la página de pago segura. No se cobra nada desde el chat ni se piden datos de tarjeta.
| Parámetro | Tipo | Descripción |
|---|---|---|
planOpcional | pro | agency | enterprise | — |
issue_status
Lectura0 créditosEstado de un problema notificado: abierto/respondido/cerrado, cuándo se notificó y la respuesta del equipo de soporte cuando la haya.
| Parámetro | Tipo | Descripción |
|---|---|---|
issue_idOpcional | string | por defecto: el último ticket |
list_open_problems
Lectura1 créditosProblemas abiertos que el análisis nocturno del asistente encontró en esta cuenta y que aún no ha visto resueltos, primero el más grave: código del problema, área (entrega, aprobación, presupuesto, pujas, seguimiento, cuenta, conexión, sincronización, feed, indexación, producción, plan), gravedad, plataforma, nombre del objetivo, el código de estado propio de la plataforma, primera y última vez que se vio y las correcciones del catálogo para cada problema con su modo (auto = mantenimiento seguro, ask = requiere la aprobación del usuario porque afecta al dinero o a un anuncio activo, manual = lo hace el usuario en la plataforma; where indica dónde). Solo lectura: no aplica ninguna corrección ni hace llamadas externas. Una lista vacía significa que el último análisis no vio ningún problema abierto.
| Parámetro | Tipo | Descripción |
|---|---|---|
severityOpcional | high | medium | low | filtro opcional |
platformOpcional | string | filtro opcional, p. ej. google, meta, search-console |
limitOpcional | integer (1–25) | — |
describe
Lectura0 créditosBusca herramientas y lee su esquema de entrada completo. Con name/names: descripción, esquema, créditos, indicadores de solo lectura/destructiva. Con query/platform: una lista corta ordenada. Úsalo para llegar a herramientas que no están en la lista visible.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameOpcional | string | — |
namesOpcional | array<string> | — |
queryOpcional | string | palabras que buscar en los nombres y descripciones de las herramientas |
platformOpcional | string | — |
read_onlyOpcional | boolean | — |
limitOpcional | integer (1–100) | — |
list_brands
Lectura0 créditosList the account's projects (brands): id, name, default flag, how many ad/analytics accounts each one uses, and which project the tools currently work with. Every tool also accepts an optional `brand` argument (project id or name) to run once in another project.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
Esta herramienta no recibe parámetros.
list_rules
Lectura0 créditosAutomation rules set up with create_rule: id, condition (if) and action (then), mode (ask = asks first, auto = applies itself, off = only watches), on/off, how often and when it last fired, plus the latest rule runs and their outcome. Read-only, free.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
Esta herramienta no recibe parámetros.
list_whatsapp_templates
Lectura1 créditosPlantillas de mensajes de WhatsApp aprobadas de la cuenta de empresa conectada: nombre, idioma y categoría. Las plantillas son necesarias para los mensajes fuera de la ventana de 24 horas. Solo lectura.
Esta herramienta no recibe parámetros.
community_summary
Lectura1 créditosResumen de comunidades: estado, precio, número de miembros activos, denuncias de contenido abiertas y cuántos miembros dieron permiso por correo / WhatsApp, el límite de comunidades del plan, la comisión estimada de Tecrübe de este mes y las cuentas de pago conectadas. Sin datos personales de los miembros. Solo lectura.
Esta herramienta no recibe parámetros.
list_integration_recipes
Lectura1 créditosRecetas de integración: el catálogo (recetas de automatización como nuevo lead → correo / Telegram / WhatsApp, nuevo pedido → notificación, alerta de campaña → canal, webhook, Slack, y guías de configuración), si el plan permite cada una y qué plan la desbloquea, cuáles llegan «pronto», las recetas instaladas con su última ejecución, las ejecuciones del mes y la preparación de los canales. Solo lectura.
Esta herramienta no recibe parámetros.
Herramientas de escritura21 herramientas
connect_account
Escritura0 créditosInicia la conexión de una cuenta de plataforma. Devuelve un enlace de autorización que el usuario debe abrir (OAuth); nada se conecta sin que el usuario inicie sesión.
| Parámetro | Tipo | Descripción |
|---|---|---|
providerObligatorio | google | meta | microsoft | tiktok | linkedin | apple | ga4 | search-console | gbp | whatsapp | shopify | youtube | ikas | x | pinterest | snapchat | reddit | yandex | tiktok-social | — |
shopOpcional | string | store address for shopify / ikas (e.g. store.myshopify.com) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_campaign
Escritura2 créditosCrea un BORRADOR de campaña (en pausa). Publicarla es un paso aparte: update_campaign(op=publish), que pasa por la puerta de aprobación. Las plataformas sin adaptador en vivo devuelven can_go_live=false con los pasos a seguir.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
platformObligatorio | google | meta | microsoft | tiktok | linkedin | apple | — |
kindOpcional | string | search | pmax | display | message | traffic | conversion |
daily_budgetOpcional | number | — |
goalOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_campaign
Escritura2 créditosPausar / reanudar / cambiar el presupuesto diario / publicar una campaña. Devuelve una vista previa y el estado: aplicado, pendiente de aprobación o simulación. Nada se aplica sin que la política de aprobación del usuario lo permita.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | — |
opObligatorio | pause | resume | budget | publish | — |
amountOpcional | number | presupuesto diario para op=budget |
currencyOpcional | string | optional ISO 4217 check; must equal the ad account currency |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_budget
Escritura2 créditosDefine un presupuesto a nivel de plataforma (no requiere id de campaña). Pasa por vista previa y aprobación; los aumentos superiores al 50 % por cambio se bloquean.
| Parámetro | Tipo | Descripción |
|---|---|---|
platformObligatorio | string | — |
amountObligatorio | number | — |
campaign_idOpcional | string | required: budgets change per campaign (list_campaigns) |
currencyOpcional | string | ISO 4217; must equal the ad account currency (no conversion) |
periodOpcional | day | week | month | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
add_negative_keywords
Escritura2 créditosAñade palabras clave negativas a una campaña de Google Ads. Crea un elemento de aprobación con vista previa; se aplica en Google solo tras la aprobación y solo con una cuenta conectada.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | — |
keywordsObligatorio | array<string> | — |
match_typeOpcional | BROAD | PHRASE | EXACT | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_rule
Escritura2 créditosConvierte una frase 'si … entonces …' en una regla de automatización (mode=ask envía cada activación a aprobación, auto la aplica dentro del guardián de gasto).
| Parámetro | Tipo | Descripción |
|---|---|---|
sentenceObligatorio | string | — |
modeOpcional | ask | auto | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_spend_guard
Escritura1 créditosPropone un cambio en el guardián de beneficios: límites de gasto diario/mensual, CPA objetivo, margen, valor medio del pedido, piloto automático. Devuelve una vista previa (anterior → nuevo) que espera la aprobación del usuario en el panel; hasta entonces no cambia nada.
| Parámetro | Tipo | Descripción |
|---|---|---|
daily_cap_tryOpcional | number (0–…) | — |
monthly_cap_tryOpcional | number (0–…) | — |
target_cpa_tryOpcional | number (0–…) | — |
margin_pctOpcional | number (0–…) | — |
aov_tryOpcional | number (0–…) | — |
autopilotOpcional | boolean | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
approve_action
EscrituraIrreversible5 créditosAplica un cambio pendiente. En dos pasos: sin confirm no se aplica nada y se devuelve la vista previa para el usuario. Pasa confirm=true solo después de que el usuario haya aprobado explícitamente esa vista previa. Un cambio propuesto por esta misma conexión no puede aprobarse aquí: el resultado incluye approve_url y el usuario lo aprueba en el panel. Devuelve aplicado / simulación / fallido.
| Parámetro | Tipo | Descripción |
|---|---|---|
action_idObligatorio | string | — |
confirmObligatorio | boolean | debe ser true; solo después de que el usuario haya aprobado explícitamente |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
reject_action
Escritura0 créditosRechaza un cambio pendiente (de list_pending_approvals) para que nunca se aplique. Úsalo cuando el usuario rechace una vista previa; no se envía nada a ninguna plataforma y el cambio desaparece de la cola de aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
action_idObligatorio | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_brand_profile
Escritura1 créditosEscribe los campos del perfil de marca cuando el usuario describe su negocio.
| Parámetro | Tipo | Descripción |
|---|---|---|
fieldsObligatorio | object | business.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone … |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
draft_ad_copy
Escritura2 créditosBorradores de texto publicitario (títulos, descripciones, llamada a la acción) a partir del perfil de marca.
| Parámetro | Tipo | Descripción |
|---|---|---|
platformOpcional | google | meta | instagram | — |
kindOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
reply_customer
EscrituraIrreversible2 créditosPropone una respuesta a un hilo de cliente en nombre del usuario (solo cuando el usuario haya dictado o aprobado el texto). Un mensaje enviado no se puede retirar, así que sigue la política de aprobación de la cuenta para mensajes a clientes (por defecto: preguntar primero; espera la aprobación en el panel).
| Parámetro | Tipo | Descripción |
|---|---|---|
thread_idObligatorio | string | — |
textObligatorio | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
report_issue
Escritura0 créditosAbre un ticket de soporte por un problema que encuentra el usuario (error de una herramienta, datos incorrectos, función que falta). Llega a la bandeja de soporte; la respuesta aparece en el panel. Devuelve issue_id para issue_status.
| Parámetro | Tipo | Descripción |
|---|---|---|
subjectObligatorio | string | — |
descriptionOpcional | string | — |
categoryOpcional | genel | fatura | baglanti | kampanya | hata | oneri | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_image
Escritura1 créditosConvierte una imagen (base64 o URL pública) en una URL pública de imagen firmada y de duración limitada que aceptan las herramientas que piden image_url. Se guarda en el área privada de archivos de la cuenta; PNG, JPEG, WEBP o GIF de hasta 5 MB.
| Parámetro | Tipo | Descripción |
|---|---|---|
image_base64Opcional | string | PNG/JPEG/WEBP/GIF, opcionalmente como URL data: |
source_urlOpcional | string | URL pública http(s) de imagen que copiar en su lugar |
filenameOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
call_write_tool
Escritura0 créditosEjecuta cualquier herramienta por su nombre: la puerta de acceso a capacidades que no aparecen en una lista de herramientas reducida. La herramienta indicada mantiene sus propias reglas: los cambios siguen devolviendo una vista previa y esperan aprobación, las conexiones de solo lectura no pueden escribir y se aplican los créditos de esa herramienta (la puerta en sí es gratuita).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | nombre exacto de la herramienta (ver describe) |
argumentsOpcional | object | los argumentos de esa herramienta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
generate_content
Escritura3 créditosGenera en un solo paso una imagen simple, un vídeo corto, un vídeo UGC, una locución o un guion a partir de una petición: EMPIEZA EN CUANTO se llama y los créditos de la producción se usan sin confirmación de precio (si los créditos no alcanzan no empieza nada: credits_exhausted). Sin nivel de calidad ni receta. Para mostrar primero el precio y obtener la aprobación del usuario, o para cualquier receta de la pantalla Producción (foto de producto, edición, influencer / avatar IA, vídeo de marca, doblaje, paquete, variaciones), use quote_production y después start_production. El guion es inmediato; los archivos tardan minutos, estado y dirección con list_productions.
| Parámetro | Tipo | Descripción |
|---|---|---|
kindObligatorio | string | image | short_video | ugc_video | voice | script |
briefOpcional | string | — |
campaign_idOpcional | string | — |
resolutionOpcional | 1K | 2K | 4K | images only |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
select_brand
Escritura0 créditosChoose the project (brand) the tools work with from now on — reports, changes and drafts then use that project's own Google/Meta accounts, site and counters. The choice is kept for your next sessions; 'default' goes back to the default project. Use list_brands to see the names.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
brandObligatorio | string | project id or name; 'default' returns to the default project |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_rule_status
Escritura0 créditosSwitch an automation rule on or off, or change its mode (ask first / apply automatically / only watch). Use it when a rule fires wrongly or the member wants to pause it. Free.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
rule_idObligatorio | string | id from list_rules |
enabledOpcional | boolean | false switches the rule off, true back on |
modeOpcional | ask | auto | off | ask | auto | off |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
send_message_to_opted_in
EscrituraIrreversible2 créditosEnvía un mensaje a cada cliente que dio su consentimiento en un canal (WhatsApp, SMS o correo electrónico). Primero muestra el número de destinatarios y pasa por aprobación. Un mensaje enviado no se puede deshacer. Nunca se incluye a personas sin consentimiento. Si el proveedor del canal no está conectado, el mensaje espera en la bandeja de salida. Para responder a una sola conversación, usa reply_customer.
| Parámetro | Tipo | Descripción |
|---|---|---|
channelObligatorio | email | sms | whatsapp | whatsapp, sms o email |
textObligatorio | string | texto del mensaje, 1600 caracteres como máximo |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
send_community_announcement
EscrituraIrreversible2 créditosPublica un anuncio en el feed de la comunidad y lo envía por correo a los miembros activos que dieron permiso (WhatsApp opcional). Primero muestra el número de destinatarios y pasa por aprobación; descuenta del cupo de correo masivo. Un mensaje enviado no se puede deshacer. Nunca llega a miembros sin permiso.
| Parámetro | Tipo | Descripción |
|---|---|---|
community_idObligatorio | string | de community_summary |
titleObligatorio | string | título del anuncio, máximo 200 caracteres |
bodyOpcional | string | cuerpo en texto plano, máximo 8000 caracteres |
whatsappOpcional | boolean | enviar también desde la cuenta de WhatsApp del negocio a los miembros que dieron permiso por WhatsApp |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
install_integration_recipe
Escritura1 créditosInstala una receta de automatización que avisa a propietarios y administradores (correo, Telegram, WhatsApp o panel) cuando ocurre su disparador. Pasa por aprobación; primero comprueba el plan y avisa si el canal no está conectado. Las recetas que necesitan una dirección de webhook o una clave secreta deben instalarse en el panel.
| Parámetro | Tipo | Descripción |
|---|---|---|
recipe_keyObligatorio | string | clave de una receta de automatización de list_integration_recipes |
channelOpcional | email | panel | telegram | whatsapp | para recetas de canal: email, telegram, whatsapp o panel |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.