Endpoint strumenti AI

POST /v1/tools/{name} esegue direttamente uno strumento di SmartChat AI, senza modello AI in mezzo. I testi che invii vengono usati parola per parola. GET /v1/tools elenca tutti gli strumenti con lo schema e se la tua chiave può usarli.

Il riferimento tecnico qui sotto è in inglese, esattamente come nomi e campi appaiono nell'API e in 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": { ... }}

Azioni in due passi

Gli strumenti che inviano, programmano, sottomettono o eliminano restituiscono prima un'anteprima e un confirm_token. Richiama lo stesso strumento con confirm_token per eseguire. Alla prima chiamata non succede nulla.

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 letturaPermesso: stats:read

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

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

Nessun campo di input.

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

Solo letturaPermesso: media:read

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

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

Nessun campo di input.

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

Modifica datiPermesso: media:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`media_id`	string	sì

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

Modifica datiPermesso: landing:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Modifica datiPermesso: landing:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`position`	any	sì
`query`	string	no

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

Solo letturaPermesso: landing:read

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

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

Campo	Tipo	Obbligatorio	Descrizione
`position`	any	no

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

Modifica datiPermesso: landing:writeUsa crediti come un messaggio a SmartChat AI

Adds a block (section) to the landing page.

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Invia, sottomette o eliminaPermesso: landing:write

Removes a block from the landing page.

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

Campo	Tipo	Obbligatorio	Descrizione
`position`	any	sì

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

Modifica datiPermesso: landing:write

Moves a block to another position on the landing page.

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

Campo	Tipo	Obbligatorio	Descrizione
`from`	any	sì
`to`	any	sì

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

Modifica datiPermesso: landing:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Modifica datiPermesso: landing:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Invia, sottomette o eliminaPermesso: landing:write

Publishes the landing page so the changes are live.

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

Nessun campo di input.

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

Modifica datiPermesso: followups:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Modifica datiPermesso: followups:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Modifica datiPermesso: followups:writeUsa crediti come un messaggio a SmartChat AI

Adds a message to a follow-up sequence.

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Invia, sottomette o eliminaPermesso: followups:write

Deletes one message from a follow-up sequence.

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

Campo	Tipo	Obbligatorio	Descrizione
`step_id`	string	sì

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

Modifica datiPermesso: followups:write

Renames a follow-up sequence.

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

Campo	Tipo	Obbligatorio	Descrizione
`sequence_id`	string	sì
`name`	string	sì

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

Modifica datiPermesso: followups:write

Pauses or starts a follow-up sequence.

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

Campo	Tipo	Obbligatorio	Descrizione
`sequence_id`	string	sì
`status`	string ("active", "paused")	sì

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

Modifica datiPermesso: newsletters:writeUsa crediti come un messaggio 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.

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Modifica datiPermesso: newsletters:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Invia, sottomette o eliminaPermesso: 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.

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

Campo	Tipo	Obbligatorio	Descrizione
`newsletter_id`	string	sì
`confirm_token`	string	no

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

Invia, sottomette o eliminaPermesso: newsletters:schedule

Sends a newsletter to the test phone number only.

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

Campo	Tipo	Obbligatorio	Descrizione
`newsletter_id`	string	sì
`to`	string	no

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

Invia, sottomette o eliminaPermesso: newsletters:schedule

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

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

Campo	Tipo	Obbligatorio	Descrizione
`newsletter_id`	string	sì
`scheduled_at`	string	sì
`confirm_token`	string	no

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

Invia, sottomette o eliminaPermesso: newsletters:schedule

Cancels a scheduled newsletter.

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

Campo	Tipo	Obbligatorio	Descrizione
`newsletter_id`	string	sì

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

Solo letturaPermesso: newsletters:read

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

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

Campo	Tipo	Obbligatorio	Descrizione
`newsletter_id`	string	sì

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

Modifica datiPermesso: templates:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Modifica datiPermesso: templates:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Invia, sottomette o eliminaPermesso: templates:delete

Deletes a template.

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

Campo	Tipo	Obbligatorio	Descrizione
`template_id`	string	sì

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

Invia, sottomette o eliminaPermesso: templates:submit

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

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

Campo	Tipo	Obbligatorio	Descrizione
`confirm_token`	string	no

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

Invia, sottomette o eliminaPermesso: templates:submit

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

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

Campo	Tipo	Obbligatorio	Descrizione
`template_id`	string	sì
`confirm_token`	string	no

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

Solo letturaPermesso: stats:read

Returns the key figures of the account.

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

Campo	Tipo	Obbligatorio	Descrizione
`range`	string ("7d", "30d", "90d")	no

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

Solo letturaPermesso: contacts:read

Lists contacts with their opt-in state and tags.

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

Campo	Tipo	Obbligatorio	Descrizione
`type`	string	no
`search`	string	no

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

Modifica datiPermesso: contacts:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`name`	string	no
`email`	string	no
`phone`	string	no

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

Invia, sottomette o eliminaPermesso: messages:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`contact_id`	string	sì
`confirm_token`	string	no

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

Modifica datiPermesso: contacts:write

Adds tags to one or more contacts.

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

Campo	Tipo	Obbligatorio	Descrizione
`tag`	string	sì
`contact_ids`	array of any	sì
`grund`	string	no

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

Modifica datiPermesso: contacts:write

Removes tags from one or more contacts.

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

Campo	Tipo	Obbligatorio	Descrizione
`tag`	string	sì
`contact_ids`	array of any	sì

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

Solo letturaPermesso: contacts:read

Exports the contacts as CSV text.

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

Nessun campo di input.

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

Modifica datiPermesso: settings:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`color`	string	no
`tonality`	string	no

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

Modifica datiPermesso: landing:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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 letturaPermesso: landing:read

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

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

Campo	Tipo	Obbligatorio	Descrizione
`text`	string	sì

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

Modifica datiPermesso: settings:write

Sets the addresses of imprint and privacy policy.

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

Campo	Tipo	Obbligatorio	Descrizione
`imprint_url`	string	no
`privacy_url`	string	no

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

Modifica datiPermesso: landing:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Modifica datiPermesso: settings:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`url`	string	sì

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

Modifica datiPermesso: settings:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`value`	string	sì
`kind`	string	no

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

Solo letturaPermesso: settings:read

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

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

Campo	Tipo	Obbligatorio	Descrizione
`query`	string	sì
`limit`	number	no

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

Modifica datiPermesso: settings:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`force`	boolean	no

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

Solo letturaPermesso: settings:readUsa crediti come un messaggio a SmartChat AI

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

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

Nessun campo di input.

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

Solo letturaPermesso: settings:read

Returns the most useful next step for the account.

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

Nessun campo di input.

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

Modifica datiPermesso: landing:writeUsa crediti come un messaggio a SmartChat AI

Loads the latest Google reviews for the landing page.

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

Nessun campo di input.

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

Solo letturaPermesso: settings:readUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`query`	string	sì
`language`	string	no

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

Solo letturaPermesso: automations:read

Lists the automations with state and trigger.

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

Nessun campo di input.

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

Modifica datiPermesso: automations:writeUsa crediti come un messaggio a SmartChat AI

Creates an automation (trigger and actions).

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

Campo	Tipo	Obbligatorio	Descrizione
`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

Modifica datiPermesso: automations:writeUsa crediti come un messaggio a SmartChat AI

Changes an automation, or pauses and activates it.

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

Campo	Tipo	Obbligatorio	Descrizione
`automation_id`	string	sì
`name`	string	no
`status`	string	no
`actions`	any	no
`trigger_config`	any	no

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

Modifica datiPermesso: automations:write

Runs an automation once with test data.

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

Campo	Tipo	Obbligatorio	Descrizione
`automation_id`	string	sì
`sample_payload`	object	no

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

Solo letturaPermesso: automations:read

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

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

Campo	Tipo	Obbligatorio	Descrizione
`automation_id`	string	sì

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

Modifica datiPermesso: automations:write

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

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

Campo	Tipo	Obbligatorio	Descrizione
`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 letturaPermesso: automations:read

Returns the latest runs of an automation.

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

Campo	Tipo	Obbligatorio	Descrizione
`automation_id`	string	sì
`limit`	number	no

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

Invia, sottomette o eliminaPermesso: automations:delete

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

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

Campo	Tipo	Obbligatorio	Descrizione
`automation_id`	string	sì
`confirm_token`	string	no

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

Modifica datiPermesso: automations:writeUsa crediti come un messaggio a SmartChat AI

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

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

Campo	Tipo	Obbligatorio	Descrizione
`name`	string	sì
`regel`	object	sì
`actions`	array of object	sì
`contact_fields`	array of string	no
`activate`	boolean	no
`confirmed`	boolean	no

Domande?

Scrivici a support@smartchat.marketing