Действия

Узнать звонящего до начала звонка

Найдите звонящего в своей системе ещё до того, как агент поздоровается.

Pre fetch спрашивает о звонящем вашу систему, пока звонок соединяется, и передаёт ответ агенту до его первого слова — так агент может поздороваться с постоянным клиентом по имени, увидеть открытый заказ или знать уровень клиента.

Настройка

1. Добавьте Pre fetch

   Откройте агента → Действия → Добавить инструмент и выберите Pre fetch вверху меню.

2. Направьте его на ваш эндпоинт

   Поле	Что указать
   Название	Короткое имя, например crm_lookup. Это же и имя блока, который читает агент
   API URL	Ваш эндпоинт, например https://crm.example.com/lookup?phone={phone}
   HTTP-метод	Лучше всего подходит GET; работают и POST, PUT, PATCH, DELETE
   Заголовки	Необязательно, например ваш API-ключ
   Query-параметры	Необязательно; новый pre fetch начинается с phone={phone}

3. Используйте подстановки

   Они заполняются для каждого звонка — в URL, заголовках и параметрах:

   Подстановка	Значение
   {phone}	Номер звонящего; при исходящем звонке — набранный номер
   {direction}	inbound или outbound
   {agent_id}	ID агента
   {user_id}	ID владельца аккаунта
   {call_id}	ID звонка — сопоставьте его с данными, которые придут после звонка

Что получает агент

Ваш ответ добавляется в инструкции агента именованным блоком. Если ваш эндпоинт вернёт { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }, агент прочитает это до приветствия. В промпте можно написать, что с этим делать, например если в контексте звонка есть имя клиента, поздоровайся с ним по имени.

Ограничения

• Только телефонные звонки — у веб-звонка нет номера, по которому искать.
• На каждый запрос — 1,5 секунды, на все вместе — 2 секунды. Медленный или сбойный эндпоинт никогда не задерживает приветствие: агент начинает без этого блока.
• Ответы длиннее 8 КБ обрезаются. Возвращайте несколько полей, а не всю карточку клиента.
• Pre fetch выполняется всегда; условия у него нет.

Примеры использования

• Здороваться с постоянными клиентами по имени.
• Знать об открытом заказе ещё до того, как звонящий о нём расскажет.
• С первой фразы иначе обслуживать VIP-номера.

См. также

• Актуальные данные во время звонка — когда агент должен сам решить во время звонка, искать ли что-то
• Отправка данных звонка в вашу систему — после звонка