Herramientas de Snapchat
Cuentas publicitarias, campañas e informes de rendimiento de Snapchat; los cambios de estado y presupuesto diario pasan por vista previa y aprobación y se pueden deshacer.
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 lectura4 herramientas
list_snapchat_ad_accounts
Lectura1 créditosCuentas de Snapchat Ads accesibles con el inicio de sesión conectado, en todas sus organizaciones: account_id, nombre, moneda, zona horaria, estado, organización y cuál está seleccionada. Solo lectura; connected=false si Snapchat no está conectado.
Esta herramienta no recibe parámetros.
list_snapchat_campaigns
Lectura1 créditosCampañas de Snapchat Ads de la cuenta: id, nombre, estado, objetivo, presupuesto diario y límite de gasto total (moneda de la cuenta), calendario, estado de entrega, además de gasto, impresiones, swipes y conversiones de compra de los últimos N días completos. Solo lectura; nunca inventa cifras (stats=null si Snapchat no devolvió ninguna).
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión |
daysOpcional | integer (1–31) | últimos N días completos, terminando ayer; por defecto 7 |
statusOpcional | active | paused | — |
snapchat_performance_report
Lectura1 créditosRendimiento de Snapchat Ads de hasta 31 días completos en la zona horaria de la cuenta: totales, desglose por campaña y filas diarias opcionales con gasto, impresiones, swipes, compras, valor de compra y añadidos al carrito. No incluye el día de hoy. Solo lectura; nunca inventa cifras.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión |
daysOpcional | integer (1–31) | últimos N días completos, terminando ayer; por defecto 7 |
campaign_idOpcional | string | limita el informe a una campaña |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD; como máximo ayer |
granularityOpcional | total | day | por defecto total |
diagnose_snapchat_delivery
Lectura1 créditosDiagnóstico de entrega EN VIVO de una campaña de Snapchat Ads. Llámala primero cuando el usuario informe de que la campaña no se entrega, está en pausa, pendiente, limitada o rechazada. Lee la cuenta publicitaria, la campaña, sus conjuntos de anuncios (códigos de estado de entrega, presupuesto, estrategia de puja, puja, valor de ROAS, ritmo) y anuncios (estado de revisión y motivos de rechazo), además del registro de cambios de la campaña y la estimación de puja de Snap; devuelve una lista de hallazgos (ámbito, código de Snap, categoría, evidencia) y cannot_read con lo que no se leyó. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión |
campaign_idObligatorio | string | id de campaña de Snapchat (list_snapchat_campaigns) |
Herramientas de escritura3 herramientas
update_snapchat_campaign_status
Escritura2 créditosPausa o activa una campaña de Snapchat Ads. Se aplica cuando el usuario lo pide, queda en el registro de auditoría y se puede deshacer con undo_action.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión |
campaign_idObligatorio | string | — |
statusObligatorio | pause | activate | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_snapchat_campaign_budget
Escritura2 créditosEstablece el presupuesto diario de una campaña de Snapchat Ads (moneda de la cuenta, mínimo 20). Se bloquean los aumentos superiores al 50 % por cambio o 2× en 24 horas; se puede deshacer con undo_action si la campaña ya tenía un presupuesto diario.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión |
campaign_idObligatorio | string | — |
daily_budgetObligatorio | number | nuevo presupuesto diario en la moneda de la cuenta, mínimo 20 |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_snapchat_campaign
Escritura5 créditosCrea una campaña de Snapchat junto con su grupo de anuncios (segmentación, presupuesto, objetivo de optimización, estrategia de puja); ambos se crean en pausa. El anuncio necesita antes una creatividad subida a Snapchat, por lo que no se crea aquí. Se aplica cuando el usuario lo pide; para publicarla, update_snapchat_campaign_status.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | Snapchat ad account id; defaults to the connection's selected account |
nameObligatorio | string | — |
daily_budgetObligatorio | number | en la moneda de la cuenta, mínimo 5 (el límite de Snapchat es 5.000.000 micro) |
objectiveOpcional | BRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES | — |
optimization_goalOpcional | IMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS | — |
bid_strategyOpcional | AUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST | — |
bidOpcional | number | — |
pixel_idOpcional | string | — |
ad_squad_nameOpcional | string | — |
start_timeOpcional | string | ISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z |
audienceOpcional | object | countries, age_min, age_max, genders |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.