Я недавно получал удовольствие от работы с API Twitter и Twilio. Сначала я выпустил инструмент для отправки и получения твитов с помощью SMS и Twilio. Во второй части я начал изучать, как было построено приложение, начиная с того, как отправить твит с помощью SMS. Теперь пришло время изучить, как работает другая сторона: как отправлять уведомления SMS, когда на Twitter происходят определенные события. Это будет немного более сложно, чем часть 2, поэтому приготовьтесь, возьмите код с GitHub и начнем.
Для этой функции мы хотим иметь возможность отправлять SMS на наш телефон, когда на Twitter происходят события, о которых мы хотим знать. Для целей этого приложения этими событиями являются прямые сообщения и упоминания.
Чтобы добиться этого, мы могли бы повторно опрашивать API Twitter, но мы могли бы обнаружить, что разница во времени между уведомлениями и тем, когда они фактически произошли, раздражает. Это может быть нормально, когда вы интересуетесь обновлениями пива из вашего местного магазина, но Twitter немного более реален, чем это. К счастью, у нас есть потоковый API Twitter, который дает нам поток событий, когда они происходят на платформе. Посмотрите на пример потокового API ниже:
Это много данных, и это даже не огнетушитель. Функция потокового API для пользовательских потоков дает нам все твиты и действия, связанные с учетной записью пользователя. Это то, что использует ваш клиент Twitter, чтобы показать вам ваш поток, и это то, что мы будем использовать, чтобы слушать уведомления для этого приложения.
Итак, план состоит в том, чтобы слушать пользовательский поток для нашей учетной записи и отправлять SMS, когда происходит прямое сообщение или упоминание. Вы можете использовать гем Twitter для потокового API, но как и большинство кода Ruby, этот гем блокирует процесс до тех пор, пока поток не будет остановлен. Если бы мы запустили это внутри приложения Sinatra, которое мы построили в предыдущем посте, мы не смогли бы одновременно ждать веб-хуков на нашем endpoint /messages и собирать и реагировать на события из потокового API. Вместо этого давайте используем гем TweetStream, который использует магию EventMachine, чтобы избежать блокировки.
EventMachine — это событийный ввод/вывод для Ruby на основе шаблона реактора. Вы, возможно, слышали о других событийных системах, таких как Python’s Twisted или молодой JavaScript-платформе Node.js. EventMachine использует цикл событий для обработки входящих событий и отправки их обработчикам событий.
TweetStream использует EventMachine для обработки событий из потокового API Twitter и отправки твитов обработчикам, которые мы определяем. Это почему мы используем Thin в качестве веб-сервера для приложения. Thin также основан на EventMachine, поэтому, когда вы запускаете сервер Thin, TweetStream может использовать тот же реактор EventMachine для обработки событий. Веб-серверы Ruby, не основанные на EventMachine, такие как стандартный WEBrick или Unicorn, не предоставляют реактора для TweetStream, поэтому гем становится неспособным слушать входящие твиты. С помощью Thin мы можем слушать потоковый API Twitter и входящие веб-запросы в рамках одного процесса.
Давайте начнем с приложения, которое у нас было в конце части 2. Если вы не написали код из части 2, вы можете склонировать репозиторий из этой точки с помощью этой команды:
Мы должны добавить TweetStream в наш Gemfile:
Затем запустите:
Как только это будет завершено, мы можем приступить к реализации TweetStream в app.rb.
Когда мы запускаем приложение, Thin запускает реактор EventMachine. Чтобы TweetStream подключился к тому же реактору, мы вызываем его внутри блока, который мы передаем в EM.schedule:
Это все, что нам нужно сделать, чтобы запустить наш слушатель потокового API и веб-приложение одновременно. Давайте посмотрим, что нам нужно сделать, когда мы получаем твит.
Сначала нам нужно начать с некоторой конфигурации. Проверьте часть 1, чтобы узнать, как найти или создать все необходимые учетные данные. Убедитесь, что разрешения для вашего приложения Twitter разрешают чтение, запись и прямые сообщения; в противном случае только части следующего будут работать.
Нам также нужно добавить еще один бит конфигурации в наш файл config/env.yml. Мы не нуждались в этом раньше, но поскольку мы теперь отправляем SMS-сообщения, нам нужно знать номер Twilio, с которого мы отправляем. Получите номер из панели управления Twilio и добавьте его как:
Как только это будет отсортировано, мы настраиваем блок для получения прямого сообщения и отправки нам SMS. Нам нужно создать новый клиент Twilio и использовать его для отправки сообщения.
Потоковый API отправляет нам все события, даже те, которые мы инициировали, поэтому нам нужно проверить, что прямое сообщение не было отправлено нашей учетной записью.
Мы также можем настроить блок для обработки упоминаний:
В этом случае нам нужно слушать все сообщения статуса таймлайна и выбирать те, которые включают упоминание нашей учетной записи. Вы, вероятно, заметили, что у нас есть немного повторения здесь, поэтому давайте приведем это в порядок. Сначала метод, который возвращает клиент Twilio, будет полезен:
Затем что-то, чтобы отправить SMS-сообщение, только тело сообщения нужно изменить каждый раз, поэтому мы можем написать:
Теперь мы можем использовать этот метод, чтобы очистить события уведомлений:
Наконец, в этом блоке мы запускаем поток одной строкой:
Мы можем запустить приложение, используя Thin, с помощью следующей команды:
Теперь попросите своих друзей отправить вам DM или @упоминание на Twitter и смотрите, как приходят SMS-сообщения!
Вот и все: за две блог-поста мы перешли от SMS к Twitter и обратно на 62 строках Ruby. Это показывает огромную мощь, доступную нам Ruby-разработчикам. С помощью нескольких гемов мы можем запустить событийный сервер, который слушает потоковый API и реагирует на веб-хуки, которые действуют как мост между нашей учетной записью Twitter и SMS.
Если у вас есть какие-либо отзывы о том, как я построил это, или есть функция, которую вы хотели бы, чтобы это приложение могло выполнять, все это на GitHub, поэтому создайте проблему или, что еще лучше, запрос на вытягивание.
Если у вас есть другие вопросы, не стесняйтесь оставить мне комментарий к этому посту или отправить мне электронное письмо по адресу philnash@twilio.com. Или отправьте мне твит @philnash, я жду вашего SMS!