Партнёрские сделки маркетплейсов в WhatsApp через WhatsApp API

Сценарий

Когда подходит этот поток

Backend уже принимает сигналы сделок маркетплейсов

Выбирайте этот поток, когда ваш backend сам ловит или принимает сигналы дешёвых товаров и скидок с Amazon, AliExpress или похожих источников и применяет правила цены, скидки и дедупликации до WhatsApp.

Монетизация через партнёрские ссылки и короткие домены

Выбирайте этот поток, когда каждый URL товара должен пройти через ваш партнёрский тег и опциональный сокращатель на backend до показа подписчикам в WhatsApp.

Назначение — канал WhatsApp, группа сделок или оба

Выбирайте этот поток, когда подписчики должны видеть офер в канале WhatsApp и/или группе сделок как post link preview, а не холодную рассылку по номерам.

Канал или групповой чат WhatsApp на телефоне с post сделки link preview: название, цена и партнёрская ссылка.

Опыт подписчика

Подписчики видят preview сделки в чате

Без автоматизации горячая цена маркетплейса попадает в ingest-пайплайн, а подписчики ждут, пока кто-то перепишет партнёрскую ссылку и вручную вставит оформленный пост.

После потока подписчики канала и участники группы видят post link preview с названием товара, ценой и tracking-URL для покупки. Интеграторы строят этот результат через WhatsApp API.

Поток работ

От сделки маркетплейса к link preview

Квалифицированная сделка маркетплейса

Backend принимает или детектирует сделку Amazon, AliExpress или аналога, подставляет партнёрский тег и опциональную короткую ссылку, готовит title, price и media preview. Whapi.Cloud не скрейпит маркетплейсы и не переписывает партнёрские id.

Один раз получить id канала

GET /newsletters

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

При необходимости получить id группы сделок

GET /groups

getGroups выводит группы, чтобы сохранить JID группы сделок при fan-out в группу — вызывайте один раз или при смене целевой группы, не на каждый SKU.

Опубликовать link preview сделки

POST /messages/link_preview

sendMessageLinkPreview отправляет переписанный URL товара в body с title и опциональной media на каждый настроенный JID; повторите вызов, если канал и группа должны получить одну сделку.

Примеры кода

Нужно отслеживать доставку? Успешный ответ send не доказывает, что подписчики уже видят post сделки. Следите за ack по webhook доставки. Статусы доставки →

Подготовка

Перед запуском потока

Подключите номер WhatsApp, который администрирует канал или группу сделок, и авторизуйте каждый запрос API-токеном этого номера. Ingest маркетплейса, перепись партнёрских ссылок и сокращатели остаются на вашем backend.

1. Создайте аккаунт Whapi.Cloud: Регистрация
2. Подключите аккаунт WhatsApp: Открыть гид
3. Найдите API-токен: Открыть раздел

Опционально — углубиться в сценарий

Обзор WhatsApp Channels API: Смотреть обзор
Автоматизация групп WhatsApp через API: Открыть гид
Обзор WhatsApp Groups API: Смотреть обзор

Реализация API

Вызовы, которые публикуют сделку

Backend уже квалифицировал сделку и держит переписанный партнёрский URL. Эти вызовы при необходимости разрешают JID назначения, затем доставляют SKU как post link preview в канал и/или группу сделок.

Получите API-токен бесплатно после регистрации на whapi.cloud и подставьте его в код вместо Your_Token из примеров.

Один раз получить id канала

Список каналов, чтобы один раз сохранить JID канала сделок до начала постов.

curl --request GET \
     --url https://gate.whapi.cloud/newsletters \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token'

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/newsletters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer Your_Token"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

url = "https://gate.whapi.cloud/newsletters"

headers = {
    "accept": "application/json",
    "authorization": "Bearer Your_Token",
}

response = requests.get(url, headers=headers)

print(response.text)

const url = 'https://gate.whapi.cloud/newsletters';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer Your_Token',
  },
});

console.log(await response.text());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/newsletters")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .build();

Response response = client.newCall(request).execute();

using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/newsletters");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://gate.whapi.cloud/newsletters", nil)
	req.Header.Set("accept", "application/json")
	req.Header.Set("authorization", "Bearer Your_Token")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

При необходимости получить id группы сделок

Список групп, чтобы сохранить JID группы сделок, если fan-out в группу включён.

curl --request GET \
     --url https://gate.whapi.cloud/groups \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token'

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/groups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer Your_Token"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

url = "https://gate.whapi.cloud/groups"

headers = {
    "accept": "application/json",
    "authorization": "Bearer Your_Token",
}

response = requests.get(url, headers=headers)

print(response.text)

const url = 'https://gate.whapi.cloud/groups';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer Your_Token',
  },
});

console.log(await response.text());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/groups")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .build();

Response response = client.newCall(request).execute();

using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/groups");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://gate.whapi.cloud/groups", nil)
	req.Header.Set("accept", "application/json")
	req.Header.Set("authorization", "Bearer Your_Token")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

Опубликовать link preview сделки

Отправить title, price и переписанный URL на каждый сохранённый JID как анонс link preview для каждой квалифицированной сделки.

curl --request POST \
     --url https://gate.whapi.cloud/messages/link_preview \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "1203632001928471@newsletter",
  "title": "Deal: wireless earbuds",
  "body": "Wireless earbuds now $29.99 \u2014 tap to buy: https://deals.example/a/xyz123",
  "media": "https://deals.example/a/xyz123/image.jpg"
}
'

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/messages/link_preview",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    "to" => "1203632001928471@newsletter",
    "title" => "Deal: wireless earbuds",
    "body" => "Wireless earbuds now $29.99 — tap to buy: https://deals.example/a/xyz123",
    "media" => "https://deals.example/a/xyz123/image.jpg",
  ]),
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer Your_Token",
    "content-type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

url = "https://gate.whapi.cloud/messages/link_preview"

payload = {
  "to": "1203632001928471@newsletter",
  "title": "Deal: wireless earbuds",
  "body": "Wireless earbuds now $29.99 — tap to buy: https://deals.example/a/xyz123",
  "media": "https://deals.example/a/xyz123/image.jpg",
}
headers = {
    "accept": "application/json",
    "authorization": "Bearer Your_Token",
    "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://gate.whapi.cloud/messages/link_preview';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer Your_Token',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    to: '1203632001928471@newsletter',
    title: 'Deal: wireless earbuds',
    body: 'Wireless earbuds now $29.99 — tap to buy: https://deals.example/a/xyz123',
    media: 'https://deals.example/a/xyz123/image.jpg',
  }),
});

console.log(await response.text());

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"to\": \"1203632001928471@newsletter\", \"title\": \"Deal: wireless earbuds\", \"body\": \"Wireless earbuds now $29.99 \u2014 tap to buy: https://deals.example/a/xyz123\", \"media\": \"https://deals.example/a/xyz123/image.jpg\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/messages/link_preview")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/messages/link_preview");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
request.AddHeader("content-type", "application/json");
request.AddJsonBody(new {
  to = "1203632001928471@newsletter",
  title = "Deal: wireless earbuds",
  body = "Wireless earbuds now $29.99 — tap to buy: https://deals.example/a/xyz123",
  media = "https://deals.example/a/xyz123/image.jpg",
});
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{"to": "1203632001928471@newsletter", "title": "Deal: wireless earbuds", "body": "Wireless earbuds now $29.99 \u2014 tap to buy: https://deals.example/a/xyz123", "media": "https://deals.example/a/xyz123/image.jpg"}`)
	req, _ := http.NewRequest("POST", "https://gate.whapi.cloud/messages/link_preview", bytes.NewReader(body))
	req.Header.Set("accept", "application/json")
	req.Header.Set("authorization", "Bearer Your_Token")
	req.Header.Set("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

Получить API KEY бесплатно

Статус доставки

Когда post сделки выходит из pending

Успешный ответ send не значит, что подписчики уже получили post сделки. Первый статус до webhook — pending. Дальнейшие изменения только на statuses.post и statuses.put. Если статус остаётся pending и не переходит в sent, delivered или следующий ack, сообщение не доставлено — проверьте payload и право аккаунта на этот тип отправки.

Застрявший pending трактуйте как недоставку, а не как ожидание webhook.
Подпишитесь на statuses.post и statuses.put, если нужны подтверждения sent/delivered для постов канала или группы.
Не помечайте сделку маркетплейса полностью опубликованной, пока статус WhatsApp остаётся pending.

Что читать про доставку и webhooks

Как выглядит webhook доставки: Смотреть callback
Какие события уходят в webhook: Список событий
Как задать webhook на канале: Открыть гид
Где взять URL webhook: Открыть гид
Примеры payload webhook: Форматы

Напишите в поддержку, если что-то пошло не так

Когда что-то ломается

Ошибки на каждом шаге

Если ingest прошёл, но перепись партнёрской ссылки не удалась, getNewsletters или getGroups не находят назначение, сохранён неверный JID, sendMessageLinkPreview отклонён на одной поверхности при успехе на другой, или post не выходит из pending, повторите или алерт — не помечайте сделку полностью опубликованной.

Сделка готова, а WhatsApp молчит?

Держите состояние сделки маркетплейса отдельно от доставки WhatsApp. Проверьте выход партнёрской и короткой ссылки на backend, сохранённые JID канала и группы, повторите sendMessageLinkPreview для упавшего назначения или алерт ops — не помечайте SKU опубликованным, пока у подписчиков нет post. Если после повтора post всё ещё падает, напишите в поддержку Whapi с id назначения и id неудачного запроса.

Напишите в поддержку, если что-то пошло не так

Разбор по шагам API

Код	Значение	Действие
`400`	Wrong request parameters	Исправьте параметры запроса списка newsletters перед повтором.
`500`	Internal Error

Код	Значение	Действие
`400`	Wrong request parameters	Исправьте параметры body link preview перед повтором.
`401`	Need channel authorization for send message	Авторизуйте канал для send message и повторите с валидным токеном.
`402`	Trial version limit exceeded
`403`	It is forbidden to send to this group/recipient	Убедитесь, что отправка на этот канал или группу разрешена, и повторите с исправленным `to`.
`404`	Media with specified id not found
`413`	Request media too large
`415`	Unsupported media type
`429`	Too many requests	Замедлите частоту и повторите позже после слишком многих запросов.
`500`	Internal Error

Код	Значение	Действие
`400`	Wrong request parameters	Исправьте параметры запроса списка groups перед повтором.
`500`	Internal Error

Частые вопросы

Сделки маркетплейсов и публикация в WhatsApp

Нет. Ваш backend принимает сигналы сделок, применяет правила партнёрских и коротких ссылок и решает, когда SKU готов к post. Whapi.Cloud получает send WhatsApp после вызова sendMessageLinkPreview с переписанным URL в body.

Нет. Разрешите и сохраните JID назначения один раз (или при смене канала/группы) и переиспользуйте id в следующих post link preview. Листинг на каждый tick сделки добавляет задержку без пользы.

Следуйте failure_mode каталога — не помечайте сделку полностью опубликованной, повторите или алерт, проверьте перепись партнёрской ссылки, сохранённые JID, отклонённые send или статус pending.

RSS-в-канал срабатывает на item feed и ссылается на URL статей CMS. Этот поток — на сигналы сделок маркетплейса с партнёрскими URL и может fan-out в группу сделок помимо канала.

Зеркалирование в Telegram или другие мессенджеры — на вашем backend. Этот job покрывает только post link preview в канал и/или группу WhatsApp.

Начать с API

Поддерживаемые функции WhatsApp

Всё, что нужно для создания автоматизации WhatsApp

Whapi.Cloud предоставляет доступ к полному набору функций WhatsApp — сообщениям, медиа, группам, каналам, вебхукам и не только. Создавайте ботов, автоматизации и интеграции без функциональных ограничений.

Выбор разработчиков

Нам доверяют 3 300+ разработчиков и SaaS-команд

Разработчики по всему миру используют Whapi.Cloud для создания автоматизаций, ботов, CRM-интеграций, массовых рассылок и продвинутых WhatsApp-воркфлоу. Наша инфраструктура обрабатывает миллионы API-запросов с высокой стабильностью — и этот показатель растёт каждый месяц.

5,5K+

активных API-каналов

21M+

API-запросов в месяц

Начать бесплатный доступ Все отзывы

«Всё просто, интуитивно и легко. Документация понятная, и вся нужная информация всегда под рукой. Отличная работа.»

Roberto K. / Web-разработчик

«Мы подключили WhatsApp к нашим процессам через n8n всего за несколько минут. Без кода, без сложностей — всё заработало с первого раза.»

Martin P. / Разработчик

«Whapi.Cloud стал важной частью нашей коммуникации с клиентами. Мы автоматизировали обновления по продуктам, уведомления о заказах и поддержку — без шаблонов и модерации.»

Oscar T. / CTO

См. также

Ещё потоки сделок и публикации

WordPress RSS в канал WhatsApp с link preview (соседний сценарий, не marketplace)

Plain text в канал при публикации CMS (соседний, не link preview сделок)

WhatsApp Channels API — публикации и управление каналами

Автоматизация групп WhatsApp — fan-out группы сделок и сохранённые JID

Обзор WhatsApp Groups API — список групп перед post сделок

Кейсы автоматизации WhatsApp для маркетплейсов и e-commerce

Когда подходит этот поток

Подписчики видят preview сделки в чате

От сделки маркетплейса к link preview

Перед запуском потока

Вызовы, которые публикуют сделку

Один раз получить id канала

При необходимости получить id группы сделок

Опубликовать link preview сделки

Когда post сделки выходит из pending

Что читать про доставку и webhooks

Ошибки на каждом шаге

Разбор по шагам API

Список каналов и выбор JID для сохранения под посты сделок. getNewsletters · GET /newsletters

Публикация link preview сделки на каждый сохранённый JID. sendMessageLinkPreview · POST /messages/link_preview

Список групп и выбор JID группы сделок при fan-out в группу. getGroups · GET /groups

Сделки маркетплейсов и публикация в WhatsApp

Whapi.Cloud сам ищет сделки Amazon или AliExpress?

Нужно ли вызывать getNewsletters и getGroups на каждую сделку?

Ingest прошёл, а подписчики не увидели сделку?

Чем это отличается от RSS в канал?

Можно дублировать сделку в Telegram через Whapi?

Всё, что нужно для создания автоматизации WhatsApp

API каналов WhatsApp

Группы и сообщества WhatsApp

Без шаблонов и модерации

Webhooks в реальном времени

Все типы медиа и сообщений

Автоматизация заказов и товаров

Проверка номеров WhatsApp

Поддержка low-code и no-code

API статусов WhatsApp

Статусы доставки и прочтения

Мульти-девайс подключение

Интерактивные сообщения и кнопки

Нам доверяют 3 300+ разработчиков и SaaS-команд

5,5K+

21M+

«Всё просто, интуитивно и легко. Документация понятная, и вся нужная информация всегда под рукой. Отличная работа.»

«Мы подключили WhatsApp к нашим процессам через n8n всего за несколько минут. Без кода, без сложностей — всё заработало с первого раза.»

Ещё потоки сделок и публикации