Skip to main content
Caller context can help an agent greet a customer or understand a support topic. Treat a phone number as a lookup input, not proof that the caller owns an account.
Twilio phone configuration and personalization authoring are separate from execution. A released inbound session path and secure provider credential handling are prerequisites for live caller personalization.

Before you begin

Review Twilio preparation, dynamic variables, and override permissions. Decide which small set of values the greeting needs. Use fictitious customer data while drafting.

Prepare the data boundary

1

Define the useful values

Keep the context narrow, such as customer_name and support_topic. Specify a neutral greeting when a value is missing. Avoid including an entire account record, payment information, or authentication credentials.
2

Verify provider requests on the server

A future inbound handler must verify the provider request before looking up a customer. Follow Twilio’s webhook security guidance and account for the exact URL and parameters used to calculate the signature. An unverified caller-supplied number must not choose a private workspace or account.
3

Apply your own account authorization

Ask for additional verification before disclosing sensitive information or taking account actions. Match the authenticated customer’s permissions to each requested operation; a personalized greeting does not authorize a tool call.
4

Review the draft and failure behavior

Store example values in the agent draft and read them back. Prepare cases for unknown numbers, failed verification, slow lookups, and missing values. Use a neutral response when private context cannot be safely retrieved.
The stored platform_settings.overrides.enable_conversation_initiation_client_data_from_webhook flag defaults to false. Authoring that policy does not create an inbound handler or prove that the platform fetches values from your service. Do not enable it as a workaround for a gated runtime.

Frequently asked questions

No. Phone numbers may be shared, recycled, or presented without proof of ownership. Apply the verification appropriate to the requested information or action.
Plan a neutral greeting that does not reveal whether a private account exists. Sensitive account access still requires verification, even when a lookup succeeds.