Ссылки m.me

Из этой статьи вы узнаете, как создать ссылки m.me в Messenger.

m.me — это сервис для сокращения URL-адресов, который предоставляет компания Meta. Он предназначен для перенаправления пользователей к человеку, веб-странице или переписке в Messenger. Вы можете использовать их на своем сайте, в электронных рассылках и для много другого.

Принцип работы

Форматом ссылки m.me является указанный ниже, в котором PAGE-NAME — это Страница Facebook, с которой связано ваше приложение для отправки сообщений.

При нажатии ссылки m.me человек перенаправляется в новую переписку с компанией (или в существующую, если ранее он отправлял сообщения вашей компании). В переписке появится сообщение по умолчанию: "Вы вошли в эту переписку, перейдя по ссылке. Мы сообщили PAGE-NAME, что вы здесь".

Вы можете добавить пользовательское сообщение в параметре text.

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

Когда человек нажимает кнопку "Начать", чтобы начать переписку с вашей компанией, на ваш сервер Webhooks отправляется уведомление Webhooks messaging_postbacks. Указанный в этом уведомлении Webhooks объект postback будет содержать объект referral с параметром ref.

Когда человек щелкает ссылку m.me, а между ним и вашей компанией уже существует переписка, ссылка перенаправит его к существующей переписке. Это действие приведет к сбросу 24-часового стандартного окна обмена сообщениями, благодаря чему ваше приложение для обмена сообщениями сможет отвечать этому человеку, а на ваш сервер Webhooks будет отправлено уведомление Webhooks messaging_referrals. В этом уведомлении Webhooks будет параметр ref из ссылки m.me.

Реферальные параметры

Ссылка m.me может содержать параметр ref. Когда человек нажимает эту ссылку, он предоставляет вашей компании дополнительный контекст в отношении переписки, например ссылку на вашем сайте, а не в магазине. Ссылки такого типа также могут направить человека к определенному контенту или функции, доступным при использовании Messenger.

QR-коды

Ссылки m.me с параметрами ref можно встроить в QR-коды. Совместимые QR-коды можно отсканировать с помощью встроенной камеры телефона. После сканирования эти коды запустят приложение Messenger и откроют переписку с вашей компанией.

Пример QR-кода Пример QR-кода содержит закодированный адрес http://m.me/OriginalCoastClothing?ref=summer_coupon, который запустит пример процесса с информацией о купоне на скидку в Messenger.

Уведомление Webhooks

Когда вы получаете уведомление Webhooks, оно содержит информацию от человека, который начинает переписку с вашей компанией или уже переписывался с ней.

Начало переписки

Когда человек нажимает кнопку "Начать", чтобы начать переписку с вашей компанией, с нашей стороны отправляется параметр ref в уведомлении Webhooks messaging_postbacks.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

Продолжение уже имеющейся переписки

Если между вашей компанией и человеком, нажавшим ссылку m.me, уже имеется переписка, будет отправлено уведомление Webhooks messaging_referrals.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

Прежде чем начать

Вам понадобятся:

• расширенный доступ для приложения, которое связано со Страницей Facebook вашей компании;
• кнопка "Начало" для использования Messenger в новых переписках;
• приложение, связанное со Страницей Facebook вашей компании и подписанное на поля Webhooks messaging_postbacks и messaging_referrals.

Ограничения

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

Запросы согласия на получение маркетинговых сообщений

URL m.me/rn позволяет создать запрос согласия на получение регулярных уведомлений с использованием ссылки m.me. Такая ссылка m.me/rn должна содержать тему регулярного уведомления. Вы можете задать частоту регулярного уведомления. По умолчанию оно будет отправлять ежедневно.

Ограничения

• Для правильной работы ссылок m.me/rn требуется iOS версии 383. Человек, нажавший ссылку, будет перенаправлен на основной URL m.me — http://m.me/PAGE-NAME.

Пример ссылки маркетингового сообщения

Регистрация темы

Чтобы использовать URL m.me/rn с новой темой, тему нужно зарегистрировать.

Если вы используете тему из предыдущей ссылки m.me/rn и люди уже давали согласие на получение регулярных уведомлений, создавать тему ещё раз не требуется.

Чтобы зарегистрировать новую тему, выполните перечисленные далее действия.

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
          "title":"TITLE",
          "payload": "Registering a new topic: TOPIC-NAME",
          "notification_messages_frequency": MESSAGE-FREQUENCY,
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

В случае успеха приложение получит следующий ответ JSON:

{ 
        "recipient": {
          "id":"PSID",
          "message_id":"MESSAGE-ID",
}

Шаг 2. Нажмите кнопку согласия в переписке. Мы отправим вам уведомление Webhooks о согласии. Теперь ваша тема зарегистрирована и готова к использованию.

Пример запроса

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

В случае успеха приложение получит следующий ответ в формате JSON:

{ "success": true }

Уведомление Webhooks messaging_optins

Когда вы получаете уведомление Webhooks, оно содержит информацию от человека, который начинает переписку с вашей компанией или уже переписывался с ней.

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "title": "TITLE-FOR-NOTIFICATION-MESSAGE",
    "ref": "REF-PARAMETER-INFORMATION",
    "payload": "",
    "source":"SHORTLINK"
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_topic": "RECURRING-NOTIFICATION-TOPIC", 
    "notification_messages_frequency": "MESSAGE-FREQUENCY",
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS"
    }
}

Справка по m.me

Дальнейшие действия

• Отправка ответа
• Отправка регулярных уведомлений

Статьи по теме

• Страница Реферальные параметры в примере приложения Original Coast Clothing
• Справка по messaging_optins
• Информация о полях события Webhooks messaging_postbacks
• Информация о полях события Webhooks messaging_referrals