smartchat

update_ai_reply_settings

Changes the given settings of the automatic AI reply; all other settings stay as they are. Turning it on needs a plan that includes it and lets SmartChat answer your customers on its own; turning it off also cancels replies that are waiting to be sent. Returns all settings.

Tool nameupdate_ai_reply_settings
Permissionai:settings
readOnlyHintfalse
destructiveHintfalse
idempotentHinttrue
openWorldHintfalse
REST callPATCH /v1/ai-reply-settings

#What it does

  • Changes data in your account. It does not send messages to contacts.
  • May start automations of the account, and an automation may send messages. The call itself sends nothing.
  • Safe to repeat. With the same idempotency_key the first answer comes back.

#Input

The tool takes one flat object. Path, query and body fields of the REST call are merged into it.

NameTypeRequiredDescription
enabledbooleannoTrue lets the AI answer incoming messages on its own. False stops it.
ai_namestring or nullnoOwn display name of the AI in the notice. Null or empty means a generic name. up to 40 characters
agent_dostring or nullnoWhat the AI should do, in your words. Null or empty clears it. up to 4000 characters
agent_neverstring or nullnoWhat the AI must never do. Null or empty clears it. up to 4000 characters
agent_memorystring or nullnoFacts the AI should know by heart. Null or empty clears it. up to 4000 characters
faqarray of objectnoThe fixed questions and answers. Replaces the whole list; items with an empty question or answer are dropped. up to 50 items
faq[].questionstringyesThe question. up to 2000 characters
faq[].answerstringyesThe answer the AI may give. up to 4000 characters

Arguments added by the MCP server (see Special arguments)

NameTypeRequiredDescription
idempotency_keystringnoOptional. Unique key, for example a UUID. Same key and arguments within 24 hours: first result. up to 255 characters

#Result

The result has the same content as the REST answer. Lists have at most 50 items per page (default 20); use cursor for the next page.

Errors come back as a tool result with isError: true. The error codes are the ones in Errors.