Примеры интеграции с помощью Webhook

С помощью webhooks вы можете передавать данные из Customer Journey практически в любой другой сервис: аналитику, CRM-системы, сервисы автоматизации маркетинга и многие другие. Например, вы можете автоматически уведомлять внешние сервисы, когда клиент совершает определенное действие в рамках Journey, отправлять данные о клиентах в ваши аналитические инструменты и запускать отправку email, SMS или сообщений WhatsApp от сторонних сервисов при наступлении определенных событий в Journey — существует множество сценариев использования, выберите свой. Узнайте больше об элементе Webhook в Customer Journeys

Этот пост показывает, как реализовать webhooks для различных сценариев использования и сервисов.

Mixpanel

Сценарий использования

Отправка данных о событиях из Journey в Mixpanel.

Предварительные требования

Аккаунт Mixpanel и ID проекта
Сервисный аккаунт

Webhook для API приема данных (https://developer.mixpanel.com/reference/events):

Пример URL

https://api.mixpanel.com/import?strict=1&project_id=XXXXXXX

Authorization: Basic UHVzaHdvb3NVTTWlrcjROZUE=
Content-Type: application/json

Пример данных

[
  {
    "event": "PW_ApplicationOpen",
    "properties": {
        "time": "{{point:48ae746b-0f54-47db-b96c-1f082e110ff4;event:PW_ApplicationOpen;attribute:datetime}}",
        "distinct_id": "{{device:hwid}}",
        "$insert_id": "48ae746b-0f54-47db-b96c-1f082e110ff4",
        "device_type": "{{point:48ae746b-0f54-47db-b96c-1f082e110ff4;event:PW_ApplicationOpen;attribute:device_type}}",
        "application_version": "{{point:48ae746b-0f54-47db-b96c-1f082e110ff4;event:PW_ApplicationOpen;attribute:application_version}}",
        "timezone": "{{tag:Timezone}}",
        "name": "{{tag:Name}}"
    }
  }
]

Amplitude

Сценарий использования

Отправка данных о событиях из Journey в Amplitude.

Предварительные требования

Аккаунт Amplitude

Webhook для API приема данных (https://developers.amplitude.com/docs/http-api-v2#request-format):

URL

https://api.amplitude.com/2/httpapi

Accept: */*Content-Type: application/json

Пример данных

{
  "api_key": "c506ffde6db9xxxxxxa50120e22ec5",
  "events": [
    {
      "user_id": "{{device:user_id}}",
      "device_id": "{{device:hwid}}",
      "event_type": "PW_ApplicationOpen",
      "user_properties": {"timezone": "{{tag:Timezone}}", "sdk_version": "{{tag:SDK Version}}"},
      "country": "{{tag:Country}}"
    }
  ]
}

Slack

Сценарий использования

Запуск отправки сообщений в Slack из Journey.

Предварительные требования

Аккаунт Slack

Пример URL

https://wavesend.slack.com/apps/XXXXXXXX-incoming-webhooks

Content-Type: application/json

Пример данных

{
"text": "Hi there :smile:",
"username": "John Doe"
}

Zapier

Сценарий использования

Отправка данных в Zapier для дальнейшего использования в автоматизациях Zapier с более чем 4000 приложений.

Предварительные требования

Аккаунт Zapier

Пример URL

https://hooks.zapier.com/hooks/catch/XXXXXXX/xxxxxxx

Content-Type: application/json

Пример данных

{
  "hwid": "{{device:hwid}}",
  "sdk": "{{tag:SDK Version}}"
}

Twilio (SMS)

Сценарий использования

Отправка SMS из Journey

Предварительные требования

Аккаунт Twilio (доступ к TWILIO_ACCOUNT_SID и TWILIO_AUTH_TOKEN)
Приобретенный номер телефона

Пример URL

https://api.twilio.com/2010-04-01/Accounts/\$TWILIO_ACCOUNT_SID/Messages.json

Content-Type: application/x-www-form-urlencoded
Authorization: Basic.... // Закодируйте TWILIO_ACCOUNT_SID и TWILIO_AUTH_TOKEN с помощью https://www.blitter.se/utils/basic-authentication-header-generator/, чтобы получить значение для Authenticate

Пример данных

From=%2B18646511557&To=%2B15852826356&Body=...