При переводе звонка на бота телефония клиента может передавать SIP-заголовки. Эти заголовки можно использовать в боте как переменные.
SIP-заголовки — это параметры, передаваемые вместе со звонком. Они содержат дополнительную информацию от телефонной системы клиента (АТС).
Для передачи переменных используйте кастомные SIP-заголовки в формате X-ИМЯ-ПЕРЕМЕННОЙ.
Пример:
X-MY-DATA: 12345
В боте автоматически будет доступна переменная:
{sip__X-MY-DATA}
Чтобы переменная распозналась корректно:
X-;sip__ (два нижних подчеркивания);| SIP-заголовок в телефонии | Доступная переменная в боте |
|---|---|
X-CLIENT-ID: abc123 |
{sip__X-CLIENT-ID} |
X-user-status: active |
{sip__X-USER-STATUS} |
X-Region-Code: RU |
{sip__X-REGION-CODE} |
Заголовки в формате X-ИМЯ-ПЕРЕМЕННОЙ передаются при переадресации звонка на платформу. Их формирует АТС в зависимости от настроек телефонной системы клиента.
Жестких ограничений по длине и количеству заголовков нет, но они должны уместиться в SIP-пакет, который передается через транспорт сети (UDP или TCP). Делайте заголовки как можно короче.
SIP-заголовки можно использовать в разных сценариях: