Диалог отправки

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

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

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

Примеры интеграции

Чтобы добавить этот диалог на свой сайт, воспользуйтесь Facebook SDK для JavaScript и выполните полное перенаправление на URL-адрес. Но имейте в виду, что этот диалог не поддерживается на мобильных устройствах.

JavaScript

С помощью Facebook SDK для JavaScript можно загрузить один и тот же URL-адрес диалога отправки:

FB.ui({
  method: 'send',
  link: 'http://www.nytimes.com/interactive/2015/04/15/travel/europe-favorite-streets.html',
});

Перенаправление на URL-адрес

http://www.facebook.com/dialog/send?
  app_id=123456789
  &amp;link=http://www.nytimes.com/interactive/2015/04/15/travel/europe-favorite-streets.html
  &amp;redirect_uri=https://www.domain.com/

Параметры

Параметр	Описание
`app_id`	Уникальный идентификатор приложения. Обязательный параметр.
`redirect_uri`	URL, на который перейдет человек, когда нажмет кнопку в диалоге. Этот параметр является обязательным, если используется перенаправление на URL.
`display`	Определяет, как отображается диалог. Этот параметр понадобится вам только в редких случаях. Как правило, мы рекомендуем использовать параметр по умолчанию. Если используется диалог перенаправления на URL-адреса, то отображается полностью вся страница на Facebook.com. Отображение такого типа называется `page`. Если используется Facebook SDK для JavaScript, то для людей, выполнивших вход в ваше приложение, по умолчанию выбирается модальный тип `iframe`, для игр на Facebook.com будет выбран тип `async`, а для всех остальных — окно `popup`.
`to`	ID получателя. После того как диалог появился, отправитель может указать в качестве получателей других людей.
`link`	Обязательный параметр. URL-адрес, который отправляется в сообщении.

Данные отклика

Этот диалог не возвращает никаких данных в качестве отклика.