Zalo — Calls

Request call consent — zalo.request_call_consent

Ask a user (by phone) for permission to call. Charged per request.

Side effect	Risk	Needs approval	Idempotent	Scopes
WRITE	high	yes	no	—

Input

Field	Type	Required	Description
phone	string	yes	Phone number. Pattern: ^\+?[0-9]{9,15}$.
call_type	string	yes	Call type as named in the Zalo call docs.
reason_code	string	yes	Reason code from the Zalo call docs.

Extra fields: ignored.

Output

Field	Type	Description
data	object	Zalo response data.

Check call consent — zalo.check_call_consent

Check whether a phone number has allowed the OA to call.

Side effect	Risk	Needs approval	Idempotent	Scopes
NONE	low	no	yes	—

Input

Field	Type	Required	Description
phone	string	yes	Phone number. Pattern: ^\+?[0-9]{9,15}$.

Extra fields: ignored.

Output

Field	Type	Description
data	object	Zalo response data.

Get call center info — zalo.get_call_center_info

Get the OA's connected call-center branches and agents.

Side effect	Risk	Needs approval	Idempotent	Scopes
NONE	low	no	yes	—

Input

No input.

Extra fields: ignored.

Output

Field	Type	Description
data	object	Zalo response data.

Create inbound call link — zalo.create_inbound_call_link

Create a link a user can open to call the OA's call center.

Side effect	Risk	Needs approval	Idempotent	Scopes
WRITE	medium	yes	no	—

Input

Field	Type	Required	Description
branch_id	string	no
agent_id	string	no	Call-center agent ID.
call_type	string	yes	Call type as named in the Zalo call docs.

Extra fields: ignored.

Output

Field	Type	Description
data	object	Zalo response data.

Create outbound call link — zalo.create_outbound_call_link

Create a link for a call-center agent to call a user.

Side effect	Risk	Needs approval	Idempotent	Scopes
WRITE	medium	yes	no	—

Input

Field	Type	Required	Description
user_id	string	yes	Zalo user ID of the OA follower.
agent_id	string	no	Call-center agent ID.
call_type	string	yes	Call type as named in the Zalo call docs.

Extra fields: ignored.

Output

Field	Type	Description
data	object	Zalo response data.