Контакты и интеграция с АТС (Yeastar)

Контакты — это ваша адресная книга: люди, которые вам звонят, с номерами, компанией и заметками. У неё своя плитка в меню приложений (справа вверху). АТС, подключённая к агенту, ищет звонящего в книге, пока звонит телефон, может добавлять тех, кого не нашла, и записывает каждый завершённый звонок в карточку контакта вместе со ссылкой на запись разговора.

Адресная книга#

• Откройте Контакты из меню приложений. Ищите по имени, компании, e-mail или номеру; нажмите на строку, чтобы увидеть контакт и его звонки.
• Новый контакт: достаточно имени, компании или номера. Номера сравниваются по последним десяти цифрам: +30 697 260 5774, 0030697… и 697… — один и тот же человек.
• Журнал звонков (меню слева) показывает все записанные звонки по всем агентам, новые первыми.

Подключение облачной АТС Yeastar P-Series#

1. Откройте Интеграции в боковом меню проекта (раздел Развёртывание) и нажмите Включить на карточке Yeastar. Одна АТС обслуживает всех агентов и общую книгу контактов, поэтому настраивается один раз для проекта. Консоль покажет Client ID и один раз client secret: скопируйте secret сразу.
2. Нажмите Скачать (bearer token, рекомендуется). Файл — это пользовательский CRM-шаблон АТС, уже заполненный нужными адресами.
3. В АТС откройте Integrations > CRM > Template Management > Upload и загрузите файл. Появится новая плитка CRM.
4. Откройте плитку, вставьте Client ID и client secret, сохраните.
5. Включите Synchronize Contacts Automatically, Create New Contact (Automatically, Inbound и Outbound) и Call Journal.
6. Сделайте тестовый звонок. Звонящий появится в Контактах, а звонок в списке внизу страницы Интеграции. Каждый записанный звонок также запускает включённых операционных агентов проекта с триггером Звонок завершён.

Почему важен «Create New Contact»#

АТС записывает только звонки, которые сопоставила с контактом. Когда включено Разрешить АТС добавлять неизвестных звонящих (по умолчанию) и Create New Contact включён в АТС, неизвестный звонящий становится контактом при первом звонке, и звонок записывается сразу. Отключите, если в книге нужны только известные контакты; звонки с неизвестных номеров тогда не записываются.

Bearer token или OAuth2?#

Шаблон bearer token проходит аутентификацию только по Client ID и secret, без страницы входа. Используйте его. Шаблон OAuth2 нужен АТС, которая требует страницу авторизации: сначала вставьте Authorized Redirect URI из АТС на страницу Интеграции проекта, затем загрузите этот шаблон; АТС откроет страницу согласия консоли, где вы нажмёте Разрешить.

Если АТС перестала работать#

• Обновить secret создаёт новый secret и отменяет старый; вставьте его в АТС.
• Выключение интеграции сразу отзывает все токены.
• Активность на странице Интеграции показывает, когда АТС последний раз обращалась к нам и сколько запросов и звонков отправила.