Представляем API управления надстройками

— API для программного управления надстройками Twilio.

— Позволяет связывать надстройку для номеров или сообщений с конкретными телефонными номерами Twilio.

— Ограниченный доступ во время предварительной версии для разработчиков.

Сегодня мы рады анонсировать API управления надстройками Twilio. Он разработан, чтобы помочь вам устанавливать и настраивать надстройки Twilio из вашего приложения – без необходимости использования веб-интерфейса!

Теперь с помощью API вы можете устанавливать, настраивать и включать надстройки программно. Он также позволяет связывать надстройку для номеров или сообщений с конкретными телефонными номерами Twilio, чтобы они активировались только для входящих вызовов или сообщений на этот номер. Вы можете запросить ранний доступ к предварительной версии API управления надстройками для разработчиков прямо сейчас.

Надстройки – это продукты от наших партнеров, предварительно интегрированные в API Twilio. Они помогают быстро добавлять новые возможности, такие как расширенная идентификация вызывающего абонента, обнаружение спама, соответствие требованиям, многоязычный преобразование речи в текст, поиск аудио и многое другое в Twilio. Они очень просты в использовании и предназначены для сокращения времени вывода новой возможности в продакшен. Вот краткий обзор того, что могут делать надстройки.

Надстройки, доступные на Маркетплейсе сегодня, делятся на 3 категории:

**Надстройки для номеров**, которые предоставляют больше данных для определенного телефонного номера.

**Надстройки для сообщений**, которые помогают анализировать содержимое текстовых сообщений.

**Надстройки для записи**, которые помогают анализировать записи, сделанные с помощью Twilio.

Если вы еще не ознакомились с ними, вот несколько полезных ссылок: каталог надстрок Twilio, руководство по надстройкам для номеров для Programmable Voice, руководство по надстройкам для записи.

Один из шаблонов, который мы видели в надстройках, заключается в том, что наши клиенты предлагают их в качестве функций в своих собственных продуктах для своих клиентов. Например, агентства цифрового маркетинга используют Twilio для маршрутизации потенциальных клиентов своим клиентам. Когда потенциальный клиент звонит на один из телефонных номеров Twilio агентства, вызов маршрутизируется к нужному клиенту. Агентство использует расширенную идентификацию вызывающего абонента, чтобы предоставить своим клиентам больше информации о вызывающем абоненте, такой как его имя, отрасль и даже доход домохозяйства. Их клиенты любят эту функциональность, потому что знание большего о том, кто звонит, позволяет им закрывать больше потенциальных клиентов.

Это работает отлично, но проблема в том, что агентства не могут достаточно быстро подключать своих клиентов. Когда они выпускают новую функцию, подобную этой, у них появляются сотни или тысячи клиентов, которые все хотят доступа. Они предоставляют кнопку в своем программном обеспечении для «добавить расширенную идентификацию вызывающего абонента». Но когда пользователь нажимает ее, он получает сообщение: «Спасибо, мы получили ваш запрос, и мы скоро свяжемся с вами». Это происходит потому, что агентство затем должно войти в Консоль Twilio и вручную включить надстройку для всех этих клиентов. Кроме того, некоторые клиенты хотят включить надстройки только для некоторых из своих телефонных номеров, но не для всех. До сих пор связь между надстройками и телефонными номерами была «всё или ничего». Это плохой опыт как для агентства, так и для их клиентов. Сегодня все меняется.

Мы рады представить API управления надстройками. Он позволяет включать и настраивать надстройки для ваших основных или дочерних аккаунтов программно. Кроме того, он поддерживает конфигурацию для каждого номера для надстроек для номеров и сообщений. Это означает, что вы можете встраивать надстройки в свое программное обеспечение, и теперь ваши пользователи смогут устанавливать их одним щелчком мыши!

Обратите внимание, что если вам нужно установить надстройку только для небольшого количества аккаунтов, возможно, по-прежнему проще сделать это через Консоль.

Вот как это работает…

Давайте начнем с поиска надстройки, которую мы хотим использовать, в Консоли и установки ее экземпляра через API. Для этого нам нужен SID доступной надстройки для этой надстройки. Обратите внимание, что вы также можете выполнить запрос списка доступных надстроек через API, чтобы получить этот SID.

Как только у вас будет SID нужной надстройки, легко установить ее экземпляр. Давайте установим надстройку VoiceBase High Accuracy Transcription, используя ее SID доступной надстройки, показанный на изображении выше.

Примечание: в этих примерах используется альфа-версия новейших библиотек-помощников Twilio, поэтому установите их, если вы хотите попробовать.

Обратите внимание, что установка надстройки не включает ее автоматическую настройку или включение. Нам придется сделать оба действия отдельно. Обычно вы захотите сохранить SID установленной надстройки, чтобы вы могли настроить, включить или отключить ее в будущем – это уникальный идентификатор для каждого установленного экземпляра надстройки.

После установки экземпляра надстройки она готова к настройке. Мы можем увидеть список ее параметров конфигурации на странице Консоли или, выполнив запрос к ним через API. Вы также можете получить конфигурацию установленной надстройки с помощью этого API.

Обратите внимание, что параметры конфигурации варьируются от надстройки к надстройке, и что не всем надстройкам нужна конфигурация. Если схема конфигурации для надстройки пуста, вы можете просто пропустить этот шаг.

На этом этапе надстройка будет выполняться каждый раз, когда любой номер в вашем аккаунте создает запись. В случае использования надстройки для номера или сообщения вы можете ограничить ее выполнение только при получении вызовов или сообщений на определенные телефонные номера, связав ее с одним или несколькими телефонными номерами Twilio. (В настоящее время это не поддерживается для надстроек записи).

Для нашего следующего примера мы переключимся на надстройку для номера – надстройку Nomorobo Spam Score, которая сообщает нам, является ли вызывающий абонент или отправитель текстового сообщения, скорее всего, робозвонком.

Итак, API управления надстройками разработан, чтобы помочь вам устанавливать и настраивать надстройки Twilio программно, чтобы вы могли создавать функции в своем приложении, которые могут быть включены без ручного вмешательства, создавая лучший пользовательский опыт для ваших пользователей.

Для получения дополнительной информации и начала работы с API управления надстройками ознакомьтесь с документацией. Обратите внимание, что этот API в настоящее время находится в предварительной версии для разработчиков, что означает:

— Чтобы использовать его, вам нужно будет запросить доступ здесь.

— Этот API поддерживается только альфа-версией новейших библиотек-помощников.

— Если вы связываете надстройку для номера или сообщения с определенным телефонным номером, эта связь не будет видна в Консоли Twilio.

Нам не терпится увидеть, что вы создадите с помощью надстроек!