Configure WhatsApp

Configure WhatsApp for the site: get_config (check if WhatsApp is set up and which number is used) or set_credentials (save Twilio/WhatsApp Business account_sid, access_token, and optional from_number). Required: action. For set_credentials also provide account_sid, access_token, and optionally from_number (e.g. +1234567890).

Input Schema

Parameter	Type	Description
action	string	One of: get_config (check if WhatsApp is configured for the site; returns configured, from_number, token_stored), set_credentials (save account_sid, access_token, and optional from_number; stores token encrypted in secure_tokens). Enum: get_config, set_credentials
account_sid	string	For set_credentials: Twilio Account SID (or WhatsApp Business phone number ID).
access_token	string	For set_credentials: Twilio Auth Token or WhatsApp API access token (stored encrypted).
from_number	string	For set_credentials: WhatsApp Business phone number in international format (e.g. +1234567890).

REST Endpoint


POST /api/agents/tools/configureWhatsApp

The site_id field is required when calling via REST.

Get current config:


POST /api/agents/tools/configureWhatsApp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "action": "get_config",
  "site_id": "YOUR_SITE_ID"
}

Set credentials:


POST /api/agents/tools/configureWhatsApp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "action": "set_credentials",
  "site_id": "YOUR_SITE_ID",
  "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "access_token": "your_auth_token",
  "from_number": "+1234567890"
}

Response:


{
  "success": true,
  "configured": true,
  "from_number": "+1234567890",
  "token_stored": true
}