Трекинг звонков с помощью Ruby и Rails

Автор: | 07.08.2026

Этот веб-приложение на Ruby on Rails демонстрирует, как можно использовать Twilio для отслеживания эффективности различных маркетинговых каналов.

Это приложение имеет три основные функции:

— Оно приобретает телефонные номера у Twilio для использования в различных маркетинговых кампаниях (например, на билбордах или рекламе в автобусах)

— Перенаправляет входящие звонки на эти номера продавцу

— Отображает графики с данными о телефонных номерах и поступающих на них звонках

В этом руководстве мы выделим ключевые фрагменты кода, которые обеспечивают работу этого приложения. Ознакомьтесь с README проекта на GitHub, чтобы узнать, как запустить код самостоятельно.

Трекинг звонков требует от нас поиска и покупки телефонных номеров по запросу, связывая конкретный номер с источником лида. Этот вспомогательный класс использует библиотеку twilio-ruby для поиска номеров по коду региона и возвращает список номеров, доступных для покупки.

Теперь давайте посмотрим, как мы будем отображать эти номера пользователю для их покупки и активации кампаний.

На главной странице приложения мы показываем пользователю форму, которая позволяет искать новый телефонный номер по коду региона. На уровне контроллера мы используем созданный ранее `TwilioClient` для фактического поиска номеров. Это отобразит представление с перечнем номеров, которые пользователь может выбрать для покупки.

Мы увидели, как можно отображать доступные для покупки телефонные номера с помощью библиотеки Twilio C#. Теперь давайте посмотрим, как можно купить доступный телефонный номер.

Наш метод `purchase_phone_number` принимает телефонный номер в качестве единственного параметра и использует наш клиент API Twilio для покупки выбранного пользователем доступного телефонного номера.

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

При покупке телефонного номера мы указываем идентификатор голосового приложения (SID). Это идентификатор для TwiML-приложения, которое можно создать через REST API или вашу консоль Twilio.

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

До сих пор наш метод создания источника лида и связывания с ним номера Twilio был довольно простым. Теперь давайте подробнее рассмотрим нашу модель `LeadSource`, которая будет хранить эту информацию.

Модель `LeadSource` связывает номер Twilio с именованным источником лида (например, «Реклама в Wall Street Journal» или «Танцующий человек с табличкой»). Она также отслеживает номер телефона, на который мы хотим перенаправлять все звонки, например, вашу линию продаж или поддержку.

Поскольку приложение будет собирать лиды и связывать их с каждым `LeadSource` или кампанией, необходимо также иметь модель `Lead` для отслеживания каждого поступающего `Lead` и связывания его с `LeadSource`.

Модель `Lead` представляет собой телефонный звонок, сгенерированный источником `LeadSource`. Каждый раз, когда кто-то звонит на номер телефона, связанный с `LeadSource`, мы будем использовать модель `Lead` для записи некоторых данных, которые Twilio предоставляет о звонке.

Бэкенд-код, который создает `LeadSource` и номер Twilio, завершен. Следующая часть приложения — это вебхуки, которые будут обрабатывать входящие звонки и перенаправлять их соответствующему сотруднику отдела продаж. Давайте посмотрим, как построены эти вебхуки.

Каждый раз, когда клиент звонит на один из наших номеров Twilio, Twilio отправляет POST-запрос на URL, связанный с этим действием (должен быть `/call-tracking/forward-call`).

Мы используем данные входящего звонка для создания нового `Lead` для `LeadSource`, затем возвращаем TwiML, который соединяет нашего звонящего с `forwarding_number` нашего `LeadSource`.

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

Одна из полезных статистик, которую мы можем получить из наших данных, — это количество звонков, полученных каждым `LeadSource`. Мы используем интерфейс запросов Active Record для создания списка, содержащего каждый `LeadSource` и количество его моделей `Lead`.

До этого момента мы фокусировались на бэкенд-коде нашего приложения, который готов начать обработку входящих звонков или лидов. Теперь давайте обратим внимание на клиентскую часть. В данном случае это простое JavaScript-приложение вместе с Chart.js, которое будет отображать эти статистические данные в подходящем виде.

На главной странице мы получаем статистику трекинга звонков в формате JSON с сервера с помощью jQuery. Мы отображаем статистику в красочных круговых диаграммах, созданных с помощью Chart.js.

Вот и всё! Наше приложение на Ruby on Rails теперь готово покупать новые телефонные номера, перенаправлять входящие звонки и записывать некоторые статистические данные для нашего бизнеса.

Если вы разработчик на Ruby on Rails, работающий с Twilio, вам также могут понравиться эти руководства:

Разместите кнопку на своей веб-странице, которая соединяет посетителей с сотрудниками службы поддержки или продаж по телефону.

Подключите ваших звонящих к IVR (интерактивному голосовому меню), позволяя им делать выбор относительно маршрутизации их звонка.

Помогло ли это руководство?

Спасибо за ознакомление с этим руководством! Если у вас есть отзывы, которыми вы хотите поделиться, свяжитесь с нами в Twitter, мы будем рады их услышать.