Пользовательский канал быстрого запуска

Требуется действие: обновите URL вебхука до 5 августа 2026 г.

Ваш URL вебхука меняется с app.respond.io на webhook.respond.io. Обновите пользовательский канал (включая SMS) до 5 августа 2026 г., иначе входящие сообщения перестанут доставляться.

Как обновить
1. В respond.io перейдите в Настройки канала > Конфигурация и скопируйте новый URL вебхука.
2. Вставьте его в поле Callback URL на Информационной панели Meta App.

Нужна помощь? Свяжитесь со службой поддержки.

Эта интеграция позволяет вашей команде общаться с клиентами по любому каналу обмена сообщениями с помощью индивидуальной реализации.

Подключение пользовательского канала

Шаг 1: Перейти к Настройки > Каналы

Шаг 2: Нажмите Добавить канал > Пользовательский канал > Подключиться

Шаг 3: Введите целевой URL-адрес Webhook, на который будут отправляться исходящие сообщения.

Шаг 4: Выберите тип идентификатора для канала > нажмите Далее

Типы идентификаторов используются для идентификации пользователя и связи с вашим пользовательским сервером интеграции.

Доступны два типа идентификаторов:

1. Номер телефона: Используйте этот вариант, если поставщик услуг обмена сообщениями распознает контакты по номеру телефона.

   1. Пример формата: +60177872890

2. Пользовательский идентификатор: используйте этот вариант, если поставщик услуг обмена сообщениями распознает контакты на основе пользовательского идентификатора.

   1. Максимальная длина — 50 символов.

   2. A-Z, a-z, 0-9, _, =, +, / и @ разрешены.

Шаг 5: В следующем диалоговом окне будут указаны ID канала, Токен API и URL вебхука, например.

1. Идентификатор канала: gfd8g7fd89dgfd

2. Токен API: aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd

3. URL вебхука: https://webhook.respond.io/custom/channel/webhook/

   Использование идентификатора номера телефона позволяет вам начать разговор и отправить первое сообщение контакту.

Передача сообщений на response.io

URL вебхука используется для отправки сообщений, эхо-сообщений и квитанций сообщений на платформу respond.io.

Предоставленный код активирует веб-хук на response.io, при необходимости создавая контакт и сохраняя сообщение под этим контактом.

Образец для сообщений

curl -X POST \\  
  https://webhook.respond.io/custom/channel/webhook/ \\  
  -H 'authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \\  
  -H 'cache-control: no-cache' \\  
  -H 'content-type: application/json' \\  
  -d '{  
  "channelId": "gfd8g7fd89dgfd",  
  "contactId": "+60177872890",  
  "events": \[  
    {  
      "type": "message",  
      "mId": "xcvzzxcxczxczxc",  
      "timestamp": 2132131321000,  
      "message": {  
        "type": "text",  
        "text": "Привет, мир"  
      }  
    }  
  \],  
  "contact": {  
    "firstName": "Джон",  
    "lastName": "Доу",  
    "profilePic": "<https://static.independent.co.uk/s3fs-public/thumbnails/image/2015/07/08/14/pic.jpg>",  
    "countryCode": "MY",  
    "email": "john@respond.io",  
    "phone": "+60177872890",  
    "language": "en"  
  }  
}'

Образец для сообщений Echo

curl -X POST \\  
  https://webhook.respond.io/custom/channel/webhook/ \\  
  -H 'authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \\  
  -H 'cache-control: no-cache' \\  
  -H 'content-type: application/json' \\  
  -d '{  
  "channelId": "gfd8g7fd89dgfd",  
  "contactId": "+60177872890",  
  "events": \[  
    {  
      "type": "message\_echo",  
      "mId": "xcvzzxcxczxczxc",  
      "timestamp": 2132131321000,  
      "message": {  
        "type": "text",  
        "text": "Привет, мир"  
      }  
    }  
  \],  
  "contact": {  
    "firstName": "Джон",  
    "lastName": "Доу",  
    "profilePic": "<https://static.independent.co.uk/s3fs-public/thumbnails/image/2015/07/08/14/pic.jpg>",  
    "countryCode": "MY",  
    "email": "john@respond.io",  
    "phone": "+60177872890",  
    "language": "en"  
  }  
}'

Образец квитанций об отправке сообщений

curl -X POST \\  
  https://webhook.respond.io/custom/channel/webhook/ \\  
  -H 'authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \\  
  -H 'cache-control: no-cache' \\  
  -H 'content-type: application/json' \\  
  -d '{  
  "channelId": "gfd8g7fd89dgfd",  
  "contactId": "+60177872890",  
  "events": \[  
    {  
      "type": "message\_status",  
      "mId": "xcvzzxcxczxczxc",  
      "timestamp": 2132131321000,  
      "status": {  
        "value": "sent|delivered|read|failed",  
        "message": "Ошибка: отправка не удалась из-за недопустимого токена"  
      }  
    }  
  \]  
}'

Ответ - Успешно (статус HTTP → 200)

"ОК"

Обработка исходящих сообщений от respond.io

respond.io вызовет конечную точку <API Base URL>/message

Убедитесь, что вы применили код Outgoing Message на маршруте /message вашего веб-сервера.

Вот пример cURL для response.io, вызывающего конечную точку:

curl -X POST \\  
  /message \\  
  -H 'Authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \\  
  -H 'Cache-Control: no-cache' \\  
  -H 'Content-Type: application/json' \\  
  -d '{  
	"channelId": "gfd8g7fd89dgfd",  
	"contactId": "+60177872890",  
	"message": {  
		"type": "text",  
		"text": "Привет, мир"  
	}  
}'

Ответ - Успешно (статус HTTP → 200)

{  
	"mId": "1640141607842"  
}

Необходимо выполнить аутентификацию на конечной точке перед отправкой сообщения поставщику услуг обмена сообщениями.

Вот пример Express middleware для этой цели:

const {validationResult} = require('express-validator');

const validateToken = (req, res, next) => {
    const apiToken = <>;
    const bearerToken = req.headers.authorization;

    if (!bearerToken)
        return res.send(401);

    const token = bearerToken.substring(7, bearerToken.length);

    if (apiToken !== token) {
        return res.send(401);
    }
    next();
};

module.exports = {
    validateToken
};

Вот пример пользовательского канала, который вы можете протестировать на своем сервере. Ознакомьтесь с нашим проектом на GitHub здесь.

Тип сообщения

Образец текста

{  
  "тип": "текст",  
  "текст": "Добро пожаловать в respond.io",  
}

Образец для медиа-файла

{  
  "тип": "вложение",  
  "вложение": {  
    "тип": "изображение|видео|аудио|файл",  
    "url": "https://abc/japan.png",  
    "mimeType": "image/png",  
    "fileName":"логотип компании.png",  
    "описание": "последний логотип компании"  
  }  
}

Убедитесь, что URL-адрес вложения не'принудительно загружен браузером. Заголовок HTTP-ответа's Content-Disposition должен иметь значение по умолчанию, то есть inline.

Образец для местоположения

{  
  "тип": "местоположение",  
  "широта": 0.123456,  
  "долгота": -0.1234,  
  "адрес": "Sky Suites, Джалан П. Рамли, Куала-Лумпур, 50250 Куала-Лумпур, Wilayah Persekutuan Kuala Lumpur"  
}

Образец для быстрого ответа

{  
  "тип": "быстрый_ответ",  
  "заголовок": "Выберите предпочитаемый язык",    
  "ответы": [  
    "Малайский",  
    "Английский"  
  ]  
}

Коды ошибок

Ошибка (статус HTTP → 4xx)

Конфигурация канала

Шаг 1: Нажмите Настройки > Каналы

Шаг 2: Найдите пользовательский канал > нажмите Управление

Шаг 3: На странице Пользовательской конфигурации канала вы увидите следующие конфигурации:

• Значок канала - Загрузите изображение, которое будет служить значком для вашего пользовательского канала.

• Название канала - Название канала можно изменить, оно используется внутри для идентификации канала.

• URL-адрес веб-перехватчика для исходящих сообщений — URL-адрес веб-перехватчика для исходящих сообщений на этот канал.

• URL-адрес веб-перехватчика для входящих сообщений — URL-адрес веб-перехватчика для входящих сообщений на этот канал.

• Тип идентификатора — Они используются для идентификации пользователя и используются для связи с вашим пользовательским сервером интеграции.

• Идентификатор канала — Уникальный идентификатор канала для идентификации вашего пользовательского канала.

• API-токен — уникальный идентификатор, используемый для аутентификации пользователя для доступа к API.

Шаг 4: Нажмите Сохранить изменения , чтобы обновить конфигурацию пользовательского канала.

Часто задаваемые вопросы по вебхукам Пользовательского канала

Почему вебхук возвращает статус 200, даже если сообщение не удалось доставить в respond.io?

При подключении Пользовательского канала сообщения, отправленные в respond.io через вебхуки, всегда будут немедленно возвращать код состояния 200, независимо от того, было ли сообщение успешно передано в respond.io. Это связано с природой вебхуков, которые предназначены для немедленного ответа без проверки успешности доставки сообщения.