Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Optimización y protección

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éditos

Resumen 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éditos

Cuentas 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ámetroTipoDescripción
platformOpcionalstringoptional filter, e.g. google, meta, microsoft
all_accessibleOpcionalbooleanalso name the tool that lists every accessible account of each platform

list_campaigns

Lectura1 créditos

Campañ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ámetroTipoDescripción
daysOpcionalinteger (1–90)—

get_report

Lectura1 créditos

Informe del período: gasto, pedidos, ingresos, ROAS, variación frente al período anterior, sugerencias. Solo lectura.

ParámetroTipoDescripción
periodOpcionalday | week | month—
platformOpcionalstringall (default) | google | meta | microsoft | tiktok | linkedin | openai-ads | ga4 | search-console
accountOpcionalstringaccount id on platforms that take one per call (microsoft, linkedin, openai-ads, ga4 property, search-console site)
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
levelOpcionalstringcampaign | ad_group | adset | ad | keyword | location | device | age_gender (what the platform supports)
breakdownOpcionalstringplatform breakdown, e.g. device, age, placement
limitOpcionalinteger (1–500)—

search_terms_report

Lectura2 créditos

Té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ámetroTipoDescripción
daysOpcionalinteger (1–90)—
campaign_idOpcionalstring—

account_audit

Lectura3 créditos

Auditorí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éditos

Cambios que esperan la aprobación del usuario (id, tipo, título).

Esta herramienta no recibe parámetros.

get_brand_profile

Lectura1 créditos

Base de conocimiento de la marca: sector, ubicación, productos, audiencia, objetivos, tono, competidores.

Esta herramienta no recibe parámetros.

research

Lectura4 créditos

Investigación web (competidor, precio, normativa del sector). Si no hay un proveedor de investigación configurado, devuelve una nota; nunca inventa resultados.

ParámetroTipoDescripción
queryObligatoriostring—

list_customers

Lectura1 créditos

Conversaciones de clientes en la bandeja de entrada (WhatsApp, Messenger, Instagram): quién escribió, último mensaje, en espera de respuesta.

ParámetroTipoDescripción
stateOpcionalneeds_you | waiting | auto | done—
limitOpcionalinteger—

list_entities

Lectura1 créditos

Lista 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ámetroTipoDescripción
platformOpcionalstringgoogle | meta | microsoft | tiktok | linkedin | openai-ads (vacío = campañas del registro de todas las plataformas)
entityOpcionalcampaigns | ad_groups | ads | keywords—
parent_idOpcionalstringid de campaña para grupos de anuncios, id de grupo de anuncios para anuncios/palabras clave (cuando la plataforma lo requiere)
accountOpcionalstringid de cuenta en las plataformas que usan una por llamada
daysOpcionalinteger (1–90)campañas del registro: cifras de los últimos N días
limitOpcionalinteger (1–500)—
offsetOpcionalinteger (0–…)—

account_snapshot

Lectura1 créditos

Imagen 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ámetroTipoDescripción
platformOpcionalstring—
accountOpcionalstringfiltra las conexiones por id de cuenta
recent_daysOpcionalinteger (1–90)—
include_inactiveOpcionalbooleanlista también las campañas en pausa/finalizadas sin gasto

get_billing_status

Lectura0 créditos

Plan 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éditos

Da 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ámetroTipoDescripción
planOpcionalpro | agency | enterprise—

issue_status

Lectura0 créditos

Estado de un problema notificado: abierto/respondido/cerrado, cuándo se notificó y la respuesta del equipo de soporte cuando la haya.

ParámetroTipoDescripción
issue_idOpcionalstringpor defecto: el último ticket

list_open_problems

Lectura1 créditos

Problemas 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ámetroTipoDescripción
severityOpcionalhigh | medium | lowfiltro opcional
platformOpcionalstringfiltro opcional, p. ej. google, meta, search-console
limitOpcionalinteger (1–25)—

describe

Lectura0 créditos

Busca 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ámetroTipoDescripción
nameOpcionalstring—
namesOpcionalarray<string>—
queryOpcionalstringpalabras que buscar en los nombres y descripciones de las herramientas
platformOpcionalstring—
read_onlyOpcionalboolean—
limitOpcionalinteger (1–100)—

list_brands

Lectura0 créditos

List 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éditos

Automation 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éditos

Plantillas 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éditos

Resumen 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éditos

Recetas 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éditos

Inicia 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ámetroTipoDescripción
providerObligatoriogoogle | meta | microsoft | tiktok | linkedin | apple | ga4 | search-console | gbp | whatsapp | shopify | youtube | ikas | x | pinterest | snapchat | reddit | yandex | tiktok-social—
shopOpcionalstringstore 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
platformObligatoriogoogle | meta | microsoft | tiktok | linkedin | apple—
kindOpcionalstringsearch | pmax | display | message | traffic | conversion
daily_budgetOpcionalnumber—
goalOpcionalstring—

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éditos

Pausar / 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ámetroTipoDescripción
campaign_idObligatoriostring—
opObligatoriopause | resume | budget | publish—
amountOpcionalnumberpresupuesto diario para op=budget
currencyOpcionalstringoptional 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éditos

Define 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ámetroTipoDescripción
platformObligatoriostring—
amountObligatorionumber—
campaign_idOpcionalstringrequired: budgets change per campaign (list_campaigns)
currencyOpcionalstringISO 4217; must equal the ad account currency (no conversion)
periodOpcionalday | 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éditos

Añ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ámetroTipoDescripción
campaign_idObligatoriostring—
keywordsObligatorioarray<string>—
match_typeOpcionalBROAD | 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éditos

Convierte 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ámetroTipoDescripción
sentenceObligatoriostring—
modeOpcionalask | 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éditos

Propone 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ámetroTipoDescripción
daily_cap_tryOpcionalnumber (0–…)—
monthly_cap_tryOpcionalnumber (0–…)—
target_cpa_tryOpcionalnumber (0–…)—
margin_pctOpcionalnumber (0–…)—
aov_tryOpcionalnumber (0–…)—
autopilotOpcionalboolean—

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éditos

Aplica 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ámetroTipoDescripción
action_idObligatoriostring—
confirmObligatoriobooleandebe 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éditos

Rechaza 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ámetroTipoDescripción
action_idObligatoriostring—

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éditos

Escribe los campos del perfil de marca cuando el usuario describe su negocio.

ParámetroTipoDescripción
fieldsObligatorioobjectbusiness.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éditos

Borradores de texto publicitario (títulos, descripciones, llamada a la acción) a partir del perfil de marca.

ParámetroTipoDescripción
platformOpcionalgoogle | meta | instagram—
kindOpcionalstring—

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éditos

Propone 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ámetroTipoDescripción
thread_idObligatoriostring—
textObligatoriostring—

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éditos

Abre 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ámetroTipoDescripción
subjectObligatoriostring—
descriptionOpcionalstring—
categoryOpcionalgenel | 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éditos

Convierte 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ámetroTipoDescripción
image_base64OpcionalstringPNG/JPEG/WEBP/GIF, opcionalmente como URL data:
source_urlOpcionalstringURL pública http(s) de imagen que copiar en su lugar
filenameOpcionalstring—

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éditos

Ejecuta 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ámetroTipoDescripción
nameObligatoriostringnombre exacto de la herramienta (ver describe)
argumentsOpcionalobjectlos 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éditos

Genera 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ámetroTipoDescripción
kindObligatoriostringimage | short_video | ugc_video | voice | script
briefOpcionalstring—
campaign_idOpcionalstring—
resolutionOpcional1K | 2K | 4Kimages 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éditos

Choose 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ámetroTipoDescripción
brandObligatoriostringproject 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éditos

Switch 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ámetroTipoDescripción
rule_idObligatoriostringid from list_rules
enabledOpcionalbooleanfalse switches the rule off, true back on
modeOpcionalask | auto | offask | 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éditos

Enví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ámetroTipoDescripción
channelObligatorioemail | sms | whatsappwhatsapp, sms o email
textObligatoriostringtexto 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éditos

Publica 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ámetroTipoDescripción
community_idObligatoriostringde community_summary
titleObligatoriostringtítulo del anuncio, máximo 200 caracteres
bodyOpcionalstringcuerpo en texto plano, máximo 8000 caracteres
whatsappOpcionalbooleanenviar 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éditos

Instala 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ámetroTipoDescripción
recipe_keyObligatoriostringclave de una receta de automatización de list_integration_recipes
channelOpcionalemail | panel | telegram | whatsapppara 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.