Update AI agent settings

Create or fully replace the AI settings for the specified entity. All fields must be provided for a complete replacement. Note that disabling the agent will make the AI stop responding to all threads. Re-enabling it will make the AI start responding to new threads only.

put

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Query parameters

agent_idstringOptional

Optional agent ID. When provided, updates the specific agent configuration. When absent, uses create-or-fetch behavior.

Header parameters

X-API-Versionstring · enumOptional

Meta Business Agent API version

Possible values:

Body

application/json

AI agent settings to create or replace

ai_audiencestring · enumOptionalPossible values:

Responses

200

The updated AI settings for the entity

application/json

The AI agent settings for an entity

agent_idstringRequiredExample: 1234567890

ai_audiencestring · enumOptionalPossible values:

channelstring · enumRequiredPossible values:

400

Bad request

application/json

401

Unauthorized

application/json

404

Not found

application/json

429

Too many requests

application/json

500

Server error

application/json

put/agent_config/settings

HTTPcURLJavaScriptPython

PUT /agent_config/settings HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 183

{
  "ai_audience": "ALLOWLISTED_ONLY",
  "followup": {
    "enabled": true,
    "followup_interval_in_seconds": 0,
    "message": "text"
  },
  "handoff": {
    "enabled": true,
    "message": "text"
  },
  "rollout": {
    "enabled": true
  }
}

{
  "agent_id": "1234567890",
  "ai_audience": "ALLOWLISTED_ONLY",
  "channel": "email",
  "followup": {
    "enabled": true,
    "followup_interval_in_seconds": 0,
    "message": "text"
  },
  "handoff": {
    "enabled": true,
    "message": "text"
  },
  "rollout": {
    "enabled": true
  }
}