Skip to main content

Change the business phone number

Updated today

This guide explains how to set the project_business_public_phone attribute so your AI Employee provides customers with the correct public phone number.

What the business phone number controls

The Business Phone attribute (project_business_public_phone) stores the official phone number that appears publicly on the business website, Google Maps, Yelp, OpenTable, or social media. The AI Employee references this number when customers ask for contact information. It is included in the agent's prompt under "Business contact information."

🚨 WARNING

The public phone number must be different from any escalation or transfer phone numbers configured for the AI Employee. If the public phone number matches an escalation number, the agent may call itself recursively, creating an infinite loop.

Set the business phone number

  1. Open the Builder.

  2. Navigate to Attributes > Business.

  3. Locate the Business Phone (Public Phone) attribute (project_business_public_phone).

  4. Enter the phone number with the full country code. Use one of the accepted formats:

  5. With plus sign: +12223334444

  6. Without plus sign: 12223334444

  7. Click Save.

Phone number guidelines by business type

Business type

What to enter

Example

Single location

The published phone number for the business.

+16505551234

Multi-location

The published phone number for the specific location this agent supports.

+14155559876

Call center

The main call center number.

+18005550100

Multiple public numbers

If the business has more than one public phone number, list all numbers separated by commas:

+16505551234, +16505555678

The AI Employee can reference any of the listed numbers when providing contact information.

❗❗ IMPORTANT

Always include the full country code. Phone numbers without a country code may not be recognized correctly by the system.

Format reference

Format

Example

Valid

E.164 with plus

+12223334444

Yes

E.164 without plus

12223334444

Yes

With dashes

1-222-333-4444

No

Without country code

2223334444

No


Changelog

Business Phone: attribute documentation

Added documentation for the Business Phone attribute (project_business_public_phone). Partners can now reference this guide when configuring the public-facing phone number used in agent responses and business contact context. Read more >

Did this answer your question?