Appearance
Page Messenger Call Settings
Version
20.0.021.0.022.0.023.0.024.0.025.0.026.0.0
Copy for LLM
Retrieve and update call settings for a Messenger Business Platform page.
Base URL
| | | | https://graph.facebook.com/v26.0 |
Endpoints
| | | | GET | /{page_id}/messenger_call_settings | | POST | /{page_id}/messenger_call_settings |
GET /{page_id}/messenger_call_settings
Request Syntax
GET /{page_id}/messenger_call_settings
Try it
Select language
cURLJavaScriptPython
curl --request GET \
--url 'https://graph.facebook.com/v26.0/{page_id}/messenger_call_settings' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data '{}'Path Parameters
page_idstring·required
The page ID for the messenger call settings
Query Parameters
fieldsstring
Comma-separated list of fields to return (call_routing, call_hours, audio_enabled, icon_enabled, video_enabled)
Responses
200
Retrieve messenger call settings
Content Type: application/json
Schema: PageMessengerCallSettingsGetResponse
Show child attributes
PageMessengerCallSettingsGetResponse
dataarray of PageMessengerCallSettingsPayload·required
Array containing call settings data (Graph API edge format)
Show child attributes
data[]PageMessengerCallSettingsPayload
Show child attributes
audio_enabledboolean
Whether audio calling is enabled
icon_enabledboolean
Whether call button icon is enabled
video_enabledboolean
Whether video calling is enabled
call_routingobject
Call routing configuration for incoming calls
Show child attributes
ring_targetOne of "META", "PARTNERS"
Target for incoming calls
call_hoursobject
Operating hours configuration for when calls are accepted
Show child attributes
timezone_idstring
Timezone identifier for call hours
weekly_operating_hoursarray of object
Weekly operating hours
Show child attributes
weekly_operating_hours[]object
Show child attributes
day_of_weekstring
Day of the week
open_timestring
Opening time in HHMM format
close_timestring
Closing time in HHMM format
400
Bad request
Content Type: application/json
Schema: StandardError
Show child attributes
StandardError
messagestring·required
typestring
codeinteger·required
error_subcodeinteger
is_transientboolean
error_data{}
error_user_msgstring
error_user_titlestring
fbtrace_idstring
403
Forbidden
Content Type: application/json
Schema: StandardError
Show child attributes
StandardError
messagestring·required
typestring
codeinteger·required
error_subcodeinteger
is_transientboolean
error_data{}
error_user_msgstring
error_user_titlestring
fbtrace_idstring
Select language
cURLJavaScriptPython
curl --request GET \
--url 'https://graph.facebook.com/v26.0/{page_id}/messenger_call_settings' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data '{}'POST /{page_id}/messenger_call_settings
Request Syntax
POST /{page_id}/messenger_call_settings
Try it
Select language
cURLJavaScriptPython
curl --request POST \
--url 'https://graph.facebook.com/v26.0/{page_id}/messenger_call_settings' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data '{}'Path Parameters
page_idstring·required
The page ID for the messenger call settings
Query Parameters
fieldsstring
Comma-separated list of fields to return (call_routing, call_hours, audio_enabled, icon_enabled, video_enabled)
Request BodyRequired
Content Type: application/json
Schema: PageMessengerCallSettingsRequest
Show child attributes
PageMessengerCallSettingsRequest
audio_enabledboolean
Enable or disable audio calling
icon_enabledboolean
Enable or disable call button icon
video_enabledboolean
Enable or disable video calling
call_routingobject
Call routing configuration for incoming calls
Show child attributes
ring_targetOne of "META", "PARTNERS"·required
Target for incoming calls
call_hoursobject
Operating hours configuration for when calls are accepted
Show child attributes
timezone_idstring·required
Timezone identifier for call hours
weekly_operating_hoursarray of object·required
Weekly operating hours
Show child attributes
weekly_operating_hours[]object
Show child attributes
day_of_weekstring·required
Day of the week
open_timestring·required
Opening time in HHMM format
close_timestring·required
Closing time in HHMM format
Responses
200
Update messenger call settings
Content Type: application/json
Schema: PageMessengerCallSettingsResponse
Show child attributes
PageMessengerCallSettingsResponse
resultstring·required
Result of the call settings update operation
400
Bad request
Content Type: application/json
Schema: StandardError
Show child attributes
StandardError
messagestring·required
typestring
codeinteger·required
error_subcodeinteger
is_transientboolean
error_data{}
error_user_msgstring
error_user_titlestring
fbtrace_idstring
403
Forbidden
Content Type: application/json
Schema: StandardError
Show child attributes
StandardError
messagestring·required
typestring
codeinteger·required
error_subcodeinteger
is_transientboolean
error_data{}
error_user_msgstring
error_user_titlestring
fbtrace_idstring
Select language
cURLJavaScriptPython
curl --request POST \
--url 'https://graph.facebook.com/v26.0/{page_id}/messenger_call_settings' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data '{}'Authentication
| | | | Scheme | Type | Location | | OAuthToken__access_token | API Key | Query: access_token | | OAuthToken__oauth_token | API Key | Query: oauth_token | | OAuthToken__Authorization | HTTP Bearer | Header: Authorization |
Usage Examples
OAuthToken__access_token:
Include access_token=your-api-key-here in query parameters
OAuthToken__oauth_token:
Include oauth_token=your-api-key-here in query parameters
OAuthToken__Authorization:
Include Authorization: Bearer your-token-here in request headers
Global Authentication Requirements
All endpoints require:
OAuthToken__access_token AND OAuthToken__oauth_token AND OAuthToken__Authorization