Endpoint herramientas IA

POST /v1/tools/{name} ejecuta directamente una herramienta de SmartChat AI, sin modelo de IA en medio. Los textos que envías se usan palabra por palabra. GET /v1/tools lista todas las herramientas con su esquema y si tu clave puede usarlas.

La referencia técnica de abajo está en inglés, exactamente como aparecen los nombres y campos en la API y en Claude.

curl -X POST https://api.smartchat.marketing/v1/tools/update_landing \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"headline": "Fresh bread every morning"}}'

{"tool": "update_landing", "ok": true, "result": { ... }}

Acciones en dos pasos

Las herramientas que envían, programan, someten o borran devuelven primero una vista previa y un confirm_token. Vuelve a llamar a la misma herramienta con confirm_token para ejecutar. En la primera llamada no pasa nada.

59 tools

get_overview list_media save_to_library update_landing swap_landing_image get_landing_blocks add_landing_block remove_landing_block move_landing_block set_landing_style update_landing_block publish_landing create_followup_sequence update_followup_step add_followup_step delete_followup_step rename_followup_sequence set_followup_status create_newsletter update_newsletter send_newsletter test_newsletter schedule_newsletter cancel_newsletter get_newsletter create_template update_template delete_template submit_all_templates submit_template get_stats list_contacts add_contact resend_optin_confirmation tag_contacts untag_contacts export_contacts update_brand set_landing_tracking find_text set_legal_urls update_website_popup scan_website set_constraint search_knowledge refresh_brain get_growth_plan get_next_step refresh_reviews web_research list_automations create_automation update_automation test_automation get_automation_setup connect_calendar get_automation_runs delete_automation create_free_automation

POST`/v1/tools/get_overview` · Get account overview

Solo lecturaPermiso: stats:read

Returns an overview of the account: landing page, templates, follow-ups, newsletters, automations and contacts with their IDs and states.

Datos (body): {"arguments": { ... }}

Sin campos de entrada.

POST`/v1/tools/list_media` · List media

Solo lecturaPermiso: media:read

Lists the images and videos in the media library with id, number, type and description.

Datos (body): {"arguments": { ... }}

Sin campos de entrada.

POST`/v1/tools/save_to_library` · Save to media library

Cambia datosPermiso: media:write

Saves an uploaded file permanently to the media library. Argument: media_id.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`media_id`	string	sí

POST`/v1/tools/update_landing` · Change landing page texts

Cambia datosPermiso: landing:writeUsa créditos como un mensaje a SmartChat AI

Changes texts and settings of the landing page. Texts are used word for word.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`headline`	string	no
`subheadline`	string	no
`cta_text`	string	no
`success_message`	string	no
`texte`	object	no
`steps_title`	string	no
`steps_intro`	string	no
`faq_title`	string	no
`proof_title`	string	no
`problem`	object	no
`solution`	object	no
`offer`	object	no
`steps`	array of object	no
`faq`	array of object	no
`reviews`	array of object	no
`color`	string	no
`heading_color`	any	no
`background_color`	any	no
`button_color`	any	no
`font`	string	no
`design_mood`	string	no
`font_pair`	string	no
`hero_image`	string	no
`hero_media`	object	no
`images`	array of string	no
`verbatim`	array of string	no	Namen der Felder, deren Text der Nutzer WÖRTLICH vorgegeben hat (z.B. ["headline"]). Diese Texte werden exakt so gespeichert - ohne Kritiker, ohne Politur. Setze das IMMER, wenn du einen Text übernimmst, den der Nutzer selbst geschrieben hat.

POST`/v1/tools/swap_landing_image` · Change landing page image

Cambia datosPermiso: landing:write

Replaces an image on the landing page with an image or video from the media library.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`position`	any	sí
`query`	string	no

POST`/v1/tools/get_landing_blocks` · Get landing page blocks

Solo lecturaPermiso: landing:read

Returns all blocks of the landing page with their ids and content.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`position`	any	no

POST`/v1/tools/add_landing_block` · Add landing page block

Cambia datosPermiso: landing:writeUsa créditos como un mensaje a SmartChat AI

Adds a block (section) to the landing page.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`type`	string	sí
`data`	object	no
`variant`	string	no
`ton`	string	no
`position`	any	no
`stil`	array of object	no

POST`/v1/tools/remove_landing_block` · Remove landing page block

Envía, somete o borraPermiso: landing:write

Removes a block from the landing page.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`position`	any	sí

POST`/v1/tools/move_landing_block` · Move landing page block

Cambia datosPermiso: landing:write

Moves a block to another position on the landing page.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`from`	any	sí
`to`	any	sí

POST`/v1/tools/set_landing_style` · Change landing page style

Cambia datosPermiso: landing:write

Changes colors, fonts and background of the landing page or of one block.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`radius`	any	no
`shadow`	any	no
`spacing`	any	no
`width`	any	no
`button`	any	no
`image`	any	no
`stil`	array of object	no

POST`/v1/tools/update_landing_block` · Change landing page block

Cambia datosPermiso: landing:writeUsa créditos como un mensaje a SmartChat AI

Changes the content or design of one block. Texts are used word for word.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`position`	any	sí
`karte`	any	no
`data`	object	no
`variant`	string	no
`ton`	string	no
`stil`	array of object	no

POST`/v1/tools/publish_landing` · Publish landing page

Envía, somete o borraPermiso: landing:write

Publishes the landing page so the changes are live.

Datos (body): {"arguments": { ... }}

Sin campos de entrada.

POST`/v1/tools/create_followup_sequence` · Create follow-up sequence

Cambia datosPermiso: followups:writeUsa créditos como un mensaje a SmartChat AI

Creates a follow-up sequence (messages after sign-up).

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`name`	string	sí
`steps`	array of object	sí
`activate`	boolean	no
`verbatim`	array of string	no

POST`/v1/tools/update_followup_step` · Change follow-up step

Cambia datosPermiso: followups:writeUsa créditos como un mensaje a SmartChat AI

Changes text, image or timing of one follow-up message. Texts are used word for word.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`step_id`	string	sí
`content`	string	no
`subject`	string	no
`delay_hours`	number	no
`verbatim`	array of string	no

POST`/v1/tools/add_followup_step` · Add follow-up step

Cambia datosPermiso: followups:writeUsa créditos como un mensaje a SmartChat AI

Adds a message to a follow-up sequence.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`sequence_id`	string	sí
`channel`	string	no
`delay_hours`	number	no
`content`	string	sí
`button`	any	no
`media`	object	no
`verbatim`	array of string	no

POST`/v1/tools/delete_followup_step` · Delete follow-up step

Envía, somete o borraPermiso: followups:write

Deletes one message from a follow-up sequence.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`step_id`	string	sí

POST`/v1/tools/rename_followup_sequence` · Rename follow-up sequence

Cambia datosPermiso: followups:write

Renames a follow-up sequence.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`sequence_id`	string	sí
`name`	string	sí

POST`/v1/tools/set_followup_status` · Pause or start follow-ups

Cambia datosPermiso: followups:write

Pauses or starts a follow-up sequence.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`sequence_id`	string	sí
`status`	string ("active", "paused")	sí

POST`/v1/tools/create_newsletter` · Create newsletter

Cambia datosPermiso: newsletters:writeUsa créditos como un mensaje a SmartChat AI

Creates a WhatsApp newsletter as draft. Texts are used word for word; media_id adds an image or video from the media library.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`subject`	string	sí
`content`	string	sí
`channel`	string	no
`media`	object	no
`cta`	object	no
`segment`	object	no

POST`/v1/tools/update_newsletter` · Change newsletter

Cambia datosPermiso: newsletters:writeUsa créditos como un mensaje a SmartChat AI

Changes text, image, video or button of a newsletter. Texts are used word for word.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`newsletter_id`	string	sí
`subject`	string	no
`content`	string	no
`media`	any	no
`cta`	any	no
`segment`	any	no

POST`/v1/tools/send_newsletter` · Send newsletter now

Envía, somete o borraPermiso: newsletters:schedule

Sends a newsletter to all confirmed contacts. First call returns the number of recipients and a confirm_token; the second call with confirm_token sends.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`newsletter_id`	string	sí
`confirm_token`	string	no

POST`/v1/tools/test_newsletter` · Send test newsletter

Envía, somete o borraPermiso: newsletters:schedule

Sends a newsletter to the test phone number only.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`newsletter_id`	string	sí
`to`	string	no

POST`/v1/tools/schedule_newsletter` · Schedule newsletter

Envía, somete o borraPermiso: newsletters:schedule

Schedules a newsletter. First call returns a preview and confirm_token; the second call with confirm_token schedules.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`newsletter_id`	string	sí
`scheduled_at`	string	sí
`confirm_token`	string	no

POST`/v1/tools/cancel_newsletter` · Cancel newsletter

Envía, somete o borraPermiso: newsletters:schedule

Cancels a scheduled newsletter.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`newsletter_id`	string	sí

POST`/v1/tools/get_newsletter` · Get newsletter

Solo lecturaPermiso: newsletters:read

Returns one newsletter with text, media, state and recipients.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`newsletter_id`	string	sí

POST`/v1/tools/create_template` · Create template

Cambia datosPermiso: templates:writeUsa créditos como un mensaje a SmartChat AI

Creates a WhatsApp template as draft. Texts are used word for word.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`name`	string	sí
`channel`	string	no
`content`	string	sí
`subject`	string	no
`buttons`	array of any	no
`media`	object	no
`verbatim`	array of string	no

POST`/v1/tools/update_template` · Change template

Cambia datosPermiso: templates:writeUsa créditos como un mensaje a SmartChat AI

Changes text, image or buttons of a template. Texts are used word for word.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`template_id`	string	sí
`name`	string	no
`content`	string	no
`subject`	string	no
`buttons`	any	no
`media`	any	no
`verbatim`	array of string	no

POST`/v1/tools/delete_template` · Delete template

Envía, somete o borraPermiso: templates:delete

Deletes a template.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`template_id`	string	sí

POST`/v1/tools/submit_all_templates` · Submit all templates

Envía, somete o borraPermiso: templates:submit

Submits all open templates to WhatsApp. First call returns the list and confirm_token; the second call with confirm_token submits.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`confirm_token`	string	no

POST`/v1/tools/submit_template` · Submit template to WhatsApp

Envía, somete o borraPermiso: templates:submit

Submits a template to WhatsApp for approval. First call returns a check and confirm_token; the second call with confirm_token submits.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`template_id`	string	sí
`confirm_token`	string	no

POST`/v1/tools/get_stats` · Get statistics

Solo lecturaPermiso: stats:read

Returns the key figures of the account.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`range`	string ("7d", "30d", "90d")	no

POST`/v1/tools/list_contacts` · List contacts

Solo lecturaPermiso: contacts:read

Lists contacts with their opt-in state and tags.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`type`	string	no
`search`	string	no

POST`/v1/tools/add_contact` · Add contact

Cambia datosPermiso: contacts:write

Adds a contact. A new contact still has to confirm the sign-up.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`name`	string	no
`email`	string	no
`phone`	string	no

POST`/v1/tools/resend_optin_confirmation` · Resend confirmation

Envía, somete o borraPermiso: messages:write

Sends the sign-up confirmation to a contact again. First call returns a preview and confirm_token.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`contact_id`	string	sí
`confirm_token`	string	no

POST`/v1/tools/tag_contacts` · Tag contacts

Cambia datosPermiso: contacts:write

Adds tags to one or more contacts.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`tag`	string	sí
`contact_ids`	array of any	sí
`grund`	string	no

POST`/v1/tools/untag_contacts` · Remove tags

Cambia datosPermiso: contacts:write

Removes tags from one or more contacts.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`tag`	string	sí
`contact_ids`	array of any	sí

POST`/v1/tools/export_contacts` · Export contacts

Solo lecturaPermiso: contacts:read

Exports the contacts as CSV text.

Datos (body): {"arguments": { ... }}

Sin campos de entrada.

POST`/v1/tools/update_brand` · Change brand

Cambia datosPermiso: settings:write

Changes brand data: name, colors, logo, tone.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`color`	string	no
`tonality`	string	no

POST`/v1/tools/set_landing_tracking` · Set tracking pixel

Cambia datosPermiso: landing:write

Sets tracking pixels (Meta, Google, TikTok) on the landing page.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`meta_pixel_id`	string	no
`meta_capi_token`	string	no
`google_id`	string	no
`gtm_id`	string	no
`tiktok_id`	string	no
`tiktok_events_token`	string	no

POST`/v1/tools/find_text` · Find text

Solo lecturaPermiso: landing:read

Finds where a text appears: landing page, popup, templates, follow-ups and newsletters. Argument: text.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`text`	string	sí

POST`/v1/tools/set_legal_urls` · Set legal pages

Cambia datosPermiso: settings:write

Sets the addresses of imprint and privacy policy.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`imprint_url`	string	no
`privacy_url`	string	no

POST`/v1/tools/update_website_popup` · Change website popup

Cambia datosPermiso: landing:writeUsa créditos como un mensaje a SmartChat AI

Changes texts, look and timing of the sign-up popup on the business website.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`headline`	string	no
`text`	string	no
`button`	string	no
`thanks_headline`	string	no
`thanks_text`	string	no
`image`	any	no
`triggers`	array of string ("time", "exit", "scroll")	no
`delay_seconds`	number	no
`scroll_percent`	number	no

POST`/v1/tools/scan_website` · Scan website

Cambia datosPermiso: settings:writeUsa créditos como un mensaje a SmartChat AI

Scans the business website again and updates the stored data. Argument: url (optional).

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`url`	string	sí

POST`/v1/tools/set_constraint` · Set a content rule

Cambia datosPermiso: settings:write

Stores a rule for all content, for example a topic that must never be mentioned.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`value`	string	sí
`kind`	string	no

POST`/v1/tools/search_knowledge` · Search business knowledge

Solo lecturaPermiso: settings:read

Searches the stored knowledge about the business (website, documents). Argument: query.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`query`	string	sí
`limit`	number	no

POST`/v1/tools/refresh_brain` · Rebuild business knowledge

Cambia datosPermiso: settings:writeUsa créditos como un mensaje a SmartChat AI

Rebuilds the stored knowledge about the business from its website and documents.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`force`	boolean	no

POST`/v1/tools/get_growth_plan` · Get growth plan

Solo lecturaPermiso: settings:readUsa créditos como un mensaje a SmartChat AI

Returns a growth plan for the business based on its data.

Datos (body): {"arguments": { ... }}

Sin campos de entrada.

POST`/v1/tools/get_next_step` · Get next step

Solo lecturaPermiso: settings:read

Returns the most useful next step for the account.

Datos (body): {"arguments": { ... }}

Sin campos de entrada.

POST`/v1/tools/refresh_reviews` · Reload reviews

Cambia datosPermiso: landing:writeUsa créditos como un mensaje a SmartChat AI

Loads the latest Google reviews for the landing page.

Datos (body): {"arguments": { ... }}

Sin campos de entrada.

POST`/v1/tools/web_research` · Research on the web

Solo lecturaPermiso: settings:readUsa créditos como un mensaje a SmartChat AI

Researches a question on the web and returns sources. Argument: query.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`query`	string	sí
`language`	string	no

POST`/v1/tools/list_automations` · List automations

Solo lecturaPermiso: automations:read

Lists the automations with state and trigger.

Datos (body): {"arguments": { ... }}

Sin campos de entrada.

POST`/v1/tools/create_automation` · Create automation

Cambia datosPermiso: automations:writeUsa créditos como un mensaje a SmartChat AI

Creates an automation (trigger and actions).

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`name`	string	sí
`trigger_type`	string	sí
`trigger_config`	object	no
`actions`	array of object	sí
`contact_fields`	array of string	no
`activate`	boolean	no

POST`/v1/tools/update_automation` · Change automation

Cambia datosPermiso: automations:writeUsa créditos como un mensaje a SmartChat AI

Changes an automation, or pauses and activates it.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`automation_id`	string	sí
`name`	string	no
`status`	string	no
`actions`	any	no
`trigger_config`	any	no

POST`/v1/tools/test_automation` · Test automation

Cambia datosPermiso: automations:write

Runs an automation once with test data.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`automation_id`	string	sí
`sample_payload`	object	no

POST`/v1/tools/get_automation_setup` · Get automation setup

Solo lecturaPermiso: automations:read

Returns how an automation is connected (webhook address, fields).

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`automation_id`	string	sí

POST`/v1/tools/connect_calendar` · Connect calendar

Cambia datosPermiso: automations:write

Connects a calendar (private iCal address) to an automation.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`automation_id`	string	sí
`calendar_url`	string	no
`provider`	string	no
`lead_minutes`	number	no

POST`/v1/tools/get_automation_runs` · Get automation runs

Solo lecturaPermiso: automations:read

Returns the latest runs of an automation.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`automation_id`	string	sí
`limit`	number	no

POST`/v1/tools/delete_automation` · Delete automation

Envía, somete o borraPermiso: automations:delete

Deletes an automation. First call returns a summary and confirm_token.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`automation_id`	string	sí
`confirm_token`	string	no

POST`/v1/tools/create_free_automation` · Create custom automation

Cambia datosPermiso: automations:writeUsa créditos como un mensaje a SmartChat AI

Creates an automation from a custom rule. First call returns a preview; the second call with confirmed: true creates it.

Datos (body): {"arguments": { ... }}

Campo	Tipo	Obligatorio	Descripción
`name`	string	sí
`regel`	object	sí
`actions`	array of object	sí
`contact_fields`	array of string	no
`activate`	boolean	no
`confirmed`	boolean	no

¿Preguntas?

Escríbenos a support@smartchat.marketing