put
https://partner.gupshup.io/partner/app//bizai/agent_config/settings
Partial update. An empty body is a no-op that returns the current settings. never_say_phrases
replaces the whole list; send [] to clear it.
Setting rollout.enabled to true fails with 400 Cannot enable Meta Business Agent until the
business has a payment method in the Billing Hub, unless ai_audience is ALLOWLISTED_ONLY.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Request parameters
| Parameter | Type | Required | In | Description |
|---|---|---|---|---|
Authorization | string | Yes | Header | Partner app token, sent raw. Bearer <token> is also accepted. |
Content-Type | string | Yes | Header | application/json |
appId | string (uuid) | Yes | Path | Partner Portal app id. Stands in for Meta's entity_id. |
agent_id | string | No | Query | Agent id from onboarding. Accepted but currently not applied as a filter. Meta pfbid… id. |
rollout | object | No | Body | Whether the agent is live for consumers. |
rollout.enabled | boolean | No | Body | Turns the agent on for consumers. Requires a payment method. |
handoff | object | No | Body | Hand-off to a human agent. |
handoff.enabled | boolean | No | Body | Whether the agent may hand off to a human. |
handoff.message | string | No | Body | Message sent on hand-off. Used when message_selection is CUSTOM. |
handoff.message_selection | string | No | Body | One of: DEFAULT, AGENT, CUSTOM. |
followup | object | No | Body | Follow-up nudge when the consumer goes quiet. |
followup.enabled | boolean | No | Body | Whether follow-ups are sent. |
followup.followup_interval_in_seconds | integer | No | Body | One of: 0, 300, 900, 1800, 3600, 7200, 28800, 86400. |
followup.message | string | No | Body | Write-only; not returned by GET. |
ai_audience | string | No | Body | Who the agent answers. ALLOWLISTED_ONLY limits it to the allowlist and needs no payment method. One of: ALLOWLISTED_ONLY, EVERYONE. |
never_say_phrases | array of string | No | Body | Phrases the agent must never use. Replaces the whole list; [] clears it. |
Example request
curl --location --request PUT 'https://partner.gupshup.io/partner/app/<appId>/bizai/agent_config/settings' \
--header 'Authorization: <PARTNER_APP_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"rollout": {
"enabled": true
},
"handoff": {
"enabled": true,
"message": "Connecting you to a human agent...",
"message_selection": "CUSTOM"
},
"followup": {
"enabled": true,
"followup_interval_in_seconds": 3600,
"message": "Are you still there?"
},
"ai_audience": "EVERYONE",
"never_say_phrases": [
"phrase1",
"phrase2"
]
}'Response parameters — 200
200| Parameter | Type | Description |
|---|---|---|
agent_id | string | Meta pfbid… id. |
channel | string | One of: email, instagram, line, messenger, sms, tiktok, unknown, webchat, whatsapp. |
rollout | object | Whether the agent is live for consumers. |
rollout.enabled | boolean | Turns the agent on for consumers. Requires a payment method. |
handoff | object | Hand-off to a human agent. |
handoff.enabled | boolean | Whether the agent may hand off to a human. |
handoff.message | string | Message sent on hand-off. Used when message_selection is CUSTOM. |
handoff.message_selection | string | One of: DEFAULT, AGENT, CUSTOM. |
followup | object | Follow-up nudge when the consumer goes quiet. |
followup.enabled | boolean | Whether follow-ups are sent. |
followup.followup_interval_in_seconds | integer | One of: 0, 300, 900, 1800, 3600, 7200, 28800, 86400. |
followup.message | string | Write-only; not returned by GET. |
ai_audience | string | Who the agent answers. ALLOWLISTED_ONLY limits it to the allowlist and needs no payment method. One of: ALLOWLISTED_ONLY, EVERYONE. |
never_say_phrases | array of string | Phrases the agent must never use. Replaces the whole list; [] clears it. |
Example response — 200 OK
200 OK{
"agent_id": "pfbid02At1HHPExampleAgentId",
"channel": "whatsapp",
"rollout": {
"enabled": true
},
"never_say_phrases": ["phrase1", "phrase2"],
"handoff": {
"enabled": true,
"message": "Connecting you to a human agent...",
"message_selection": "CUSTOM"
},
"followup": {
"enabled": true,
"followup_interval_in_seconds": 3600
},
"ai_audience": "EVERYONE"
}Error responses
400 Bad Request — The app is not live, or WASS does not consider it live.
{
"message": "App is not live.",
"status": "error"
}400 Bad Request — The app has no phone number attached. Checked before the live check.
{
"message": "Phone id not found for the given App",
"status": "error"
}401 Unauthorized — Authorization is missing or invalid, belongs to another app, or appId is unknown or not a UUID.
{
"status": "error",
"message": "Unauthorised access to the resource. Please review request parameters and headers and retry"
}405 Method Not Allowed — Any method other than GET, POST, PUT or DELETE, e.g. PATCH.
{
"status": "error",
"message": "Request method 'PATCH' is not supported"
}429 Too Many Requests — More than 30 /bizai/** requests in 60 seconds for this app. The 31st is rejected.
{
"status": "error",
"message": "Too Many Requests"
}Per-app rate limit exceeded. Retry after the 60-second window.