Chat Widgets API

Manage social chat widgets and their per-widget chat settings.

Base URL: https://your-site.com/wp-json/wpsocialreviews/v2

Policy: WidgetsPolicy

---

List Widgets

GET /chat-widgets

Handler: WidgetsController@index

Parameter	Type	Location	Required	Description
search	string	query	No	Search by title

Response

{
  "message": "success",
  "items": { "data": [], "total": 0 },
  "total_items": 0
}

---

Create · Status · Duplicate · Delete

Action	Method	Endpoint	Handler	Inputs	Response
Create	POST	/chat-widgets	@create	onboarding (bool)	{ "template_id": 88 }
Status	PUT	/chat-widgets	@update	ids[], status (publish/draft/pending/private/trash)	{ "message" }
Duplicate	POST	/chat-widgets/duplicate	@duplicate	ids[]	{ "message", "item", "item_id" }
Delete	DELETE	/chat-widgets	@delete	ids[]	{ "message" }

---

Chat Meta

Nested under /chat-widgets/meta/chats/{id}. Handler: Platforms/Chats/MetaController. The {id} must be a wpsr_social_chats post, otherwise a 404 is returned. Reading/saving fires the get_chat_settings / update_chat_settings / delete_chat_settings actions.

Method	Endpoint	Handler	Inputs
GET	/chat-widgets/meta/chats/{id}	@index	path {id}
PUT	/chat-widgets/meta/chats/{id}	@update	path {id}, args (JSON chat settings)
DELETE	/chat-widgets/meta/chats/{id}/edit	@delete	path {id}