Configuring phone numbers for bots

Each bot has a unique name that identifies it. The bot is associated with a session by the 'uri' field in the SBC Start message.

Mapping phone numbers to bots can be done in the SBC (typically by using Dial Plan).

Another way to associate phone numbers to bots is to add the phone number to the phoneNumbers field in the bot configuration. This field is an array, so it is possible to have multiple phone numbers per bot. A uri that contains a phone number that is listed in the 'phoneNumbers' field will be routed to the bot.

This feature is applicable only to VoiceAI Connect Enterprise (Version 2.6 and later).

In earlier versions, only the uri field with the bot name was used; now phone numbers can be used as well.

Configuration

Use the following bot parameter to configure one or more phone numbers.

How to use it?

The following parameter is used for assigning phone numbers to bots:

Parameter

Type

Description

phoneNumbers

String Array

Defines phone number(s) for the bot.

Note:

  • The phone number must be unique and associated to only one bot..

  • If this parameter is not configured (default), the uri field (in the start message) with the bot name is used.

  • If this parameter is configured but the ‘uri’ field in the received (SBC) start message only contains the bot name, the VAIC will identify the proper bot.

The following shows an example of a bot configuration with two phone numbers associated to the “LondonTube” bot:

{
  "name": "LondonTube",
  "provider": "my_azure",
  "displayName": "LondonTube",
  "credentials": {
    "botSecret": "..."
  },
  "phoneNumbers": [
    "+9991234567",
    "+11671671"
  ]
}