🚀 Курс Onboarding: API и Техническая Поддержка

Полное руководство по работе с API для специалистов 1-й линии поддержки

📚 14 модулей • 30 минут чтения • Интерактивный тест

📋 Содержание курса

1 Основы API 2 HTTP протокол 3 Цикл Запрос-Ответ 4 Формат JSON 5 Анатомия запроса 6 HTTP методы 7 Коды ответов 8 Инструменты 9 Вебхуки 10 Практические примеры 11 Wappi.pro API 12 Решение проблем 13 Глоссарий 14 Финальный тест

🌐 1. Основы API

API (Application Programming Interface) — это набор правил, по которым одна программа может взаимодействовать с другой. В нашем случае, клиенты используют наш API, чтобы их CRM-системы (Bitrix24, AmoCRM) могли "общаться" с мессенджерами (WhatsApp, Telegram и др.).

💬

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

CRM отправляет сообщения клиентам через WhatsApp

📥

Получение сообщений

Входящие сообщения автоматически попадают в CRM

🔄

Синхронизация

Диалоги синхронизируются между устройствами

🤖

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

Боты и автоответы без участия человека

🍽️ Аналогия "Ресторан":

Представьте ресторан — это поможет понять, как работает API:

Клиент (Гость): Пользователь API — тот, кто делает заказ (отправляет запрос).
Официант (API): Посредник, который принимает заказ и передает его на кухню. Он знает меню (документацию) и правила.
Кухня (Сервер): Место, где готовят блюдо (обрабатывают запрос) и отдают результат.
Меню (Документация): Список того, что можно заказать и как правильно это сделать.

Почему это важно знать?
Понимание основ API поможет вам быстрее находить причины проблем у клиентов и объяснять им решения простым языком.

📡 2. Что такое HTTP и как он работает

HTTP (HyperText Transfer Protocol) — это протокол передачи данных в интернете. Проще говоря, это "язык общения" между вашим браузером (или программой) и сервером.

📬 Представьте почту:

Вы (Клиент): Пишете письмо с вопросом и отправляете его по адресу.
Почта (HTTP): Доставляет письмо до адресата по определенным правилам.
Получатель (Сервер): Читает письмо, готовит ответ и отправляет обратно.

🔄 Что происходит под капотом? (Пошагово)

Клиент формирует запрос. Например: "Хочу отправить сообщение в WhatsApp номеру 79990000000".
Запрос упаковывается по правилам HTTP: добавляется метод (POST), заголовки (токен), тело (текст сообщения в JSON).
Запрос отправляется по адресу: https://wappi.pro/api/sync/message/send.
Сервер получает запрос, обрабатывает: проверяет токен, читает данные, отправляет сообщение через WhatsApp API.
Сервер формирует ответ: код статуса (200 = успех), тело ответа (например, ID сообщения).
Клиент получает ответ и показывает результат пользователю.

🌍 Где используется HTTP?

Применение	Пример	Что происходит
Веб-сайты	Открыть google.com	Браузер отправляет GET запрос, получает HTML страницу
API (наш случай)	Отправить WhatsApp сообщение	CRM отправляет POST запрос к нашему API
Мобильные приложения	Обновить ленту Instagram	Приложение запрашивает новые посты через API

HTTPS vs HTTP: HTTPS — это HTTP с шифрованием. Все данные (токены, пароли) передаются зашифрованно. Наш API работает только по HTTPS для безопасности. Если клиент пытается использовать http:// — это ошибка!

🔄 3. Цикл Запрос-Ответ (Request-Response)

Каждое взаимодействие с API — это цикл из двух частей: отправка запроса и получение ответа.

📤 Запрос (Request) — что мы отправляем

Пример реального запроса к нашему API:

POST /api/sync/message/send?profile_id=71ad40e9-b023 HTTP/1.1
Host: wappi.pro
Authorization: sk_test_1234567890abcdef
Content-Type: application/json

{
    "body": "Привет! Это тестовое сообщение.",
    "recipient": "79990000000"
}

Разбор по частям:

POST — метод (что делаем).
/api/sync/message/send?profile_id=... — путь и параметры (куда стучимся).
Authorization: ... — заголовок с токеном (кто мы).
{"body": "...", "recipient": "..."} — тело запроса (что отправляем).

📥 Ответ (Response) — что возвращает сервер

Пример успешного ответа:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "status": "done",
    "message_id": "3EB0128AE55B5D222DD0",
    "task_id": "57411bfb-8f19-4d19-b6c1-2457b5164fd2"
}

Разбор:

200 OK — код статуса (всё прошло успешно).
Content-Type: application/json — тип данных в ответе.
{"status": "done", ...} — само тело ответа с результатом.

Важно: Если запрос неправильный (неверный токен, забыли параметр), сервер всё равно вернет ответ, но с кодом ошибки (например, 401 или 400).

📋 4. Формат JSON — язык данных API

JSON (JavaScript Object Notation) — это формат для передачи данных. Почти все современные API используют именно JSON. Это как "общий язык" между программами.

📝 Как выглядит JSON?

{
    "name": "Иван Петров",
    "phone": "79990001122",
    "age": 25,
    "is_active": true,
    "orders": ["заказ1", "заказ2", "заказ3"],
    "address": {
        "city": "Москва",
        "street": "Ленина, 1"
    }
}

🧱 Типы данных в JSON

Тип	Пример	Описание
Строка (String)	`"Привет"`	Текст в двойных кавычках
Число (Number)	`42` или `3.14`	Целые или дробные числа без кавычек
Логический (Boolean)	`true` или `false`	Да/Нет, без кавычек
Массив (Array)	`["a", "b", "c"]`	Список значений в квадратных скобках
Объект (Object)	`{"key": "value"}`	Вложенная структура в фигурных скобках
Null	`null`	Пустое значение

⚠️ Частые ошибки в JSON

❌ Неправильно:

{
    'name': 'Иван',        // Одинарные кавычки — ОШИБКА!
    "phone": 79990001122,  // Номер телефона должен быть строкой
    "text": "Привет"       // Нет запятой после — ОШИБКА!
    "active": True         // True с большой буквы — ОШИБКА!
}

✅ Правильно:

{
    "name": "Иван",
    "phone": "79990001122",
    "text": "Привет",
    "active": true
}

Совет для саппорта: Если клиент получает ошибку 400, первым делом проверьте его JSON! Используйте онлайн-валидатор jsonlint.com — он покажет, где ошибка.

1.4. Реальный пример из жизни техподдержки

Ситуация: Клиент пишет: "Не могу отправить сообщение, что делать?"

🔍 Шаг 1: Смотрим, что клиент отправляет

Просим скриншот или лог запроса. Видим:

POST https://wappi.pro/api/sync/message/send?profile_id=abc123
Authorization: wrong_token_here
Content-Type: application/json

{
    "body": "Тест",
    "recipient": "79990000000"
}

Проблема: Токен неверный (wrong_token_here).

📡 Шаг 2: Сервер отвечает

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
    "detail": "Invalid token"
}

Код 401 говорит нам: "Авторизация не прошла".

✅ Шаг 3: Решение

Пишем клиенту: "Проверьте токен в заголовке Authorization. Его можно найти в личном кабинете на странице профиля."

Почему это важно знать?

Понимая, как работает HTTP (запрос → обработка → ответ), вы сможете:

Быстро находить, где ошибка (в запросе клиента или на сервере).
Объяснять клиентам простым языком, что не так.
Читать логи и понимать, что происходит.

🔬 5. Анатомия HTTP запроса

Чтобы отправить запрос, нам нужно собрать "конструктор" из 4-х частей:

🔗

URL (Адрес)

Куда мы стучимся
https://wappi.pro/api/message/send

⚡

Method (Метод)

Что мы хотим сделать
GET, POST, PUT, DELETE

📑

Headers (Заголовки)

Служебная информация
Авторизация, тип данных

📦

Body (Тело)

Сами данные
Только для POST/PUT

🔗 Разбор URL

https://wappi.pro/api/sync/message/send?profile_id=abc123&timeout=30
  │        │         │                      │
  │        │         │                      └── Query параметры (после ?)
  │        │         └── Endpoint (путь к методу)
  │        └── Host (домен сервера)
  └── Protocol (https = безопасно)

📑 Важные заголовки (Headers)

Заголовок	Пример	Зачем нужен
`Authorization`	`sk_your_api_token`	Идентификация клиента (кто делает запрос)
`Content-Type`	`application/json`	Формат данных в Body
`Accept`	`application/json`	Какой формат ответа мы ожидаем

Частая ошибка: Клиент забывает указать Content-Type: application/json при отправке POST запроса. Сервер не понимает формат данных и возвращает ошибку.

⚡ 6. HTTP методы (GET, POST, PUT, DELETE)

Метод определяет, какое действие мы хотим выполнить. Это как глаголы в языке.

GET

Получить данные

Читаем информацию, ничего не меняем. Тело запроса пустое.

POST

Создать / Отправить

Создаем новое или выполняем действие. Данные в Body.

PUT

Обновить полностью

Заменяем существующий ресурс целиком.

DELETE

Удалить

Удаляем ресурс. Обычно без Body.

📊 Методы в Wappi.pro API

Метод	Пример endpoint	Что делает
GET	`/sync/get/status`	Получить статус профиля
GET	`/sync/get/qr`	Получить QR-код для авторизации
POST	`/sync/message/send`	Отправить текстовое сообщение
POST	`/sync/message/img/send`	Отправить изображение
DELETE	`/sync/profile/delete`	Удалить профиль

Как понять какой метод использовать?
Мы не выбираем метод наугад — это определяет разработчик API. Смотрите документацию! Если написано POST, а вы отправите GET — сервер вернет ошибку 405 Method Not Allowed.

🛠️ 8. Инструменты для работы с API

Браузер умеет отправлять только GET запросы (когда вы открываете ссылку). Для полноценной работы нужны специальные программы.

🟠

Postman

Самый популярный. Удобный интерфейс, коллекции запросов, история.

🟣

Insomnia

Легкая альтернатива Postman. Минималистичный дизайн.

⬛

cURL

Командная строка. Любят программисты. Работает везде.

🌐

Браузер DevTools

F12 → Network. Смотрите все запросы на странице.

💻 Пример cURL

cURL часто используют на серверах и в документации. Разберем команду:

curl -X POST "https://wappi.pro/api/sync/message/send?profile_id=your_id" \
     -H "Authorization: your_token" \
     -H "Content-Type: application/json" \
     -d '{"body": "Hello World", "recipient": "79990000000"}'

Разбор флагов:

-X POST — указываем HTTP метод
-H "..." — добавляем заголовок (Header)
-d '...' — передаем данные (Body)
\ — перенос строки для читаемости

🔍 Как использовать DevTools браузера

Откройте сайт клиента или наш личный кабинет
Нажмите F12 или Ctrl+Shift+I
Перейдите во вкладку Network
Выполните действие (например, отправьте сообщение)
Найдите запрос в списке и кликните на него
Смотрите: Headers, Payload (Body), Response

Совет: Научитесь читать запросы в DevTools — это поможет понять, что именно отправляет клиент, даже если он сам не может это объяснить.

🚦 7. Коды ответов (Status Codes)

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

✅ Успешные ответы (2xx)

200 OK — Запрос выполнен успешно. Всё хорошо!
201 Created — Ресурс успешно создан (например, новый профиль).

⚠️ Ошибки клиента (4xx)

400 Bad Request — Ошибка в запросе. Проверьте JSON, обязательные параметры.
401 Unauthorized — Проблема с авторизацией. Неверный токен или его нет.
403 Forbidden — Доступ запрещен. Токен верный, но нет прав.
404 Not Found — Ресурс не найден. Проверьте URL и profile_id.
405 Method Not Allowed — Неверный метод. Используете GET вместо POST?
429 Too Many Requests — Слишком много запросов. Превышен лимит.

❌ Ошибки сервера (5xx)

500 Internal Server Error — Ошибка на нашей стороне. Эскалируйте разработчикам!
502 Bad Gateway — Проблема с промежуточным сервером.
503 Service Unavailable — Сервис временно недоступен. Технические работы.

Мнемоника для запоминания:
2xx = 😊 Всё хорошо
4xx = 🤔 Клиент ошибся (проблема на стороне пользователя)
5xx = 😱 Сервер сломался (проблема на нашей стороне)

🔔 9. Что такое Webhooks (Вебхуки)

Webhook (Вебхук) — это способ автоматически получать уведомления от нашего сервера, когда что-то происходит. Это как "обратный звонок" от сервера к клиенту.

🍕 Представьте пиццерию:

Без вебхука (Polling): Вы каждые 5 минут звоните: "Готова пицца?" — неудобно и тратит ресурсы.
С вебхуком (Push): Оставляете номер, и пиццерия сама позвонит, когда готово. Удобно!

⚙️ Как работают вебхуки?

Настройка: Клиент указывает URL своего сервера (webhook_url) в настройках профиля.
Событие: Происходит что-то важное (пришло сообщение, доставлено, профиль разлогинился).
Уведомление: Наш сервер автоматически отправляет POST запрос на URL клиента.
Обработка: Сервер клиента получает данные и делает что-то (записывает в CRM, отвечает).

📨 Типы вебхуков

wh_type	Событие	Когда приходит
`incoming_message`	Входящее сообщение	Кто-то написал в WhatsApp
`delivery_status`	Статус доставки	Сообщение доставлено/прочитано
`outgoing_message_phone`	Исходящее с телефона	Клиент сам написал с телефона
`authorization_status`	Статус авторизации	Профиль авторизован/разлогинен
`incoming_call`	Входящий звонок	Кто-то звонит в WhatsApp

📋 Пример вебхука на входящее сообщение

{
  "messages": [{
    "wh_type": "incoming_message",
    "profile_id": "6qw54f68-71eq",
    "id": "3A945DD9CDD3016BE11B",
    "body": "Привет, как дела?",
    "type": "chat",
    "from": "79115576366@c.us",
    "to": "79602041988@c.us",
    "senderName": "Иван",
    "timestamp": "2024-10-21T11:27:57+03:00"
  }]
}

Важно: Webhook — это POST запрос от НАШЕГО сервера К серверу клиента. Клиент должен иметь публичный URL (localhost не работает!) и возвращать 200 OK.

🔄 Механизм повторной отправки (Retry)

Если сервер клиента не вернул 200 OK, наш сервис автоматически повторяет отправку вебхука:

Попытка	Задержка	Общее время
1-я (первая)	сразу	0 мин
2-я	5 минут	5 мин
3-я	10 минут	15 мин
4-я	20 минут	35 мин
5-я (последняя)	30 минут	65 мин

Всего 5 попыток. Если после 5-й попытки ответ всё ещё не 200 — вебхук считается недоставленным.

Совет: Сервер клиента должен отвечать 200 OK как можно быстрее (в идеале < 5 сек). Обработку данных лучше выполнять асинхронно, после ответа.

⚠️ Частые проблемы с вебхуками

Вебхуки не приходят: Проверьте URL (доступен из интернета?), настройки профиля, ответ сервера.
Приходят не все события: Проверьте webhook_types в настройках.
Дубликаты: Сервер клиента долго отвечает, мы повторяем отправку.

Инструменты для тестирования:
• webhook.site — бесплатный URL для приема вебхуков
• ngrok — туннель для localhost (для разработчиков)

🎯 10. Практические примеры из жизни техподдержки

Разберем реальные ситуации, с которыми вы столкнетесь в работе.

📋 Сценарий 1: "Не могу отправить сообщение"

Клиент пишет: "Пытаюсь отправить сообщение через API, но получаю ошибку."

Ваши действия:

Попросите показать HTTP ответ (код + тело)
Посмотрите код ответа:
- 401 → Проверьте токен
- 400 → Проверьте JSON и обязательные поля
- 404 → Проверьте profile_id
Проверьте статус профиля: GET /sync/get/status

📋 Сценарий 2: "Вебхуки не приходят"

Клиент пишет: "Настроил webhook, но ничего не приходит."

Чек-лист проверки:

URL доступен из интернета? (не localhost!)
URL указан в настройках профиля?
Сервер клиента возвращает 200 OK?
Нужный wh_type включен в настройках?
Попросите протестировать через webhook.site

📋 Сценарий 3: "Профиль постоянно разлогинивается"

Возможные причины:

WhatsApp открыт на телефоне одновременно с несколькими устройствами
Клиент нажал "Выход из всех устройств" в WhatsApp
WhatsApp заблокировал номер (подозрительная активность)

Рекомендации: Пересканировать QR, не использовать номер параллельно.

Золотое правило саппорта: Всегда просите клиента показать полный HTTP ответ (код + тело), а не просто "не работает". Это сэкономит время вам обоим!

📱 11. Работа с API Wappi.pro

Наш API позволяет управлять профилями WhatsApp и отправлять сообщения. Основные моменты:

Base URL: https://wappi.pro/api/
Authorization: Токен передается в заголовке (Header) Authorization.
Profile ID: Передается как параметр запроса ?profile_id=....

Пример 1: Получение статуса профиля

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

GET /sync/get/status?profile_id={{profile_id}}

// Заголовок
Authorization: ваш_токен_api

// Ответ (Успех)
{
    "app_status": "open",
    "authorized": true,
    "message_count": 1438,
    "name": "Профиль 1",
    "phone": "79602041980",
    "profile_id": "71ad40e9-b023",
    "status": "done"
}

Пример 2: Отправка текстового сообщения

Самый частый запрос. Обратите внимание на формат JSON в теле запроса.

POST /sync/message/send?profile_id={{profile_id}}

Body (JSON):

{
    "body": "Привет! Это тестовое сообщение от техподдержки.",
    "recipient": "79115554444"
}

Ответ:

{
    "status": "done",
    "message_id": "3EB0128AE55B5D222DD0",
    "task_id": "57411bfb-8f19-4d19-b6c1-2457b5164fd2"
}

Пример 3: Отправка картинки (Base64)

Если клиент хочет отправить файл напрямую, не по ссылке.

POST /sync/message/img/send?profile_id={{profile_id}}

{
    "recipient": "79995579399",
    "caption": "Это картинка",
    "b64_file": "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"
}

🔧 12. Частые проблемы и решения

Справочник типичных ошибок и способов их решения.

❌ Ошибка 401 Unauthorized

Причина: Неверный токен или токен не передан в заголовке.

Решение:

Проверьте заголовок Authorization — токен должен быть без кавычек
Токен можно найти в личном кабинете на странице профиля
Убедитесь, что нет лишних пробелов или переносов строк

⚠️ Ошибка 400 Bad Request

Причина: Ошибка в JSON или отсутствует обязательный параметр.

Решение:

Проверьте JSON через jsonlint.com
Убедитесь, что все кавычки двойные ", а не одинарные
Проверьте обязательные поля: body, recipient
Номер телефона должен быть строкой с цифрами (без +, пробелов и скобок)

🔍 Ошибка 404 Not Found

Причина: Неверный URL или profile_id.

Решение:

Проверьте правильность endpoint (опечатки в URL)
Убедитесь, что profile_id существует и указан верно
Профиль может быть удален — проверьте в личном кабинете

📱 Сообщение отправлено (200), но не доходит

Возможные причины:

Профиль не авторизован — проверьте GET /sync/get/status
Номер получателя не в WhatsApp — проверьте GET /sync/contact/check
Телефон получателя выключен или нет интернета — статус будет undelivered
WhatsApp временно заблокировал рассылку — слишком много сообщений

🔄 Профиль постоянно разлогинивается

Причины и решения:

WhatsApp открыт на нескольких устройствах — закройте лишние сессии
Клиент нажал "Выход" в настройках WhatsApp на телефоне
Подозрительная активность — WhatsApp требует повторную авторизацию
Телефон потерял интернет-соединение надолго

Алгоритм диагностики:
1️⃣ Попросите код ответа HTTP
2️⃣ Попросите тело ответа (JSON)
3️⃣ Проверьте статус профиля
4️⃣ Проверьте логи на стороне клиента

📖 13. Глоссарий терминов

Справочник основных терминов, которые вы встретите в работе.

Термин	Объяснение
API	Application Programming Interface — набор правил для взаимодействия программ
HTTP	Протокол передачи данных в интернете
HTTPS	HTTP с шифрованием (безопасный)
REST API	Архитектурный стиль API, использующий HTTP методы
Endpoint	Конкретный URL метода API (например, /message/send)
Request	Запрос — то, что мы отправляем на сервер
Response	Ответ — то, что сервер возвращает
Header	Заголовок — служебная информация запроса (токен, тип данных)
Body	Тело запроса — основные данные (JSON)
JSON	JavaScript Object Notation — формат данных в API
Token	Уникальный ключ для авторизации в API
Profile ID	Уникальный идентификатор профиля WhatsApp
Webhook	Автоматическое уведомление от сервера на URL клиента
Polling	Периодический опрос сервера (менее эффективен, чем webhook)
Status Code	Код ответа HTTP (200, 400, 401, 500...)
QR-код	Код для авторизации профиля WhatsApp
Base64	Способ кодирования файлов в текст для передачи через API
cURL	Инструмент командной строки для HTTP запросов
Postman	Программа с графическим интерфейсом для работы с API

✍️ 14. Проверь себя! Финальный тест

Пройди тест и проверь, насколько хорошо ты усвоил материал. Нужно правильно ответить минимум на 10 из 14 вопросов (70%).

Wappi.pro Academy

📋 Содержание курса

🌐 1. Основы API

📡 2. Что такое HTTP и как он работает

🔄 Что происходит под капотом? (Пошагово)

🌍 Где используется HTTP?

🔄 3. Цикл Запрос-Ответ (Request-Response)

📤 Запрос (Request) — что мы отправляем

📥 Ответ (Response) — что возвращает сервер

📋 4. Формат JSON — язык данных API

📝 Как выглядит JSON?

🧱 Типы данных в JSON

⚠️ Частые ошибки в JSON

1.4. Реальный пример из жизни техподдержки

🔍 Шаг 1: Смотрим, что клиент отправляет

📡 Шаг 2: Сервер отвечает

✅ Шаг 3: Решение

🔬 5. Анатомия HTTP запроса

🔗 Разбор URL

📑 Важные заголовки (Headers)

⚡ 6. HTTP методы (GET, POST, PUT, DELETE)

📊 Методы в Wappi.pro API

🛠️ 8. Инструменты для работы с API

💻 Пример cURL

🔍 Как использовать DevTools браузера

🚦 7. Коды ответов (Status Codes)

✅ Успешные ответы (2xx)

⚠️ Ошибки клиента (4xx)

❌ Ошибки сервера (5xx)

🔔 9. Что такое Webhooks (Вебхуки)

⚙️ Как работают вебхуки?

📨 Типы вебхуков

📋 Пример вебхука на входящее сообщение

🔄 Механизм повторной отправки (Retry)

⚠️ Частые проблемы с вебхуками

🎯 10. Практические примеры из жизни техподдержки

📋 Сценарий 1: "Не могу отправить сообщение"

📋 Сценарий 2: "Вебхуки не приходят"

📋 Сценарий 3: "Профиль постоянно разлогинивается"

📱 11. Работа с API Wappi.pro

Пример 1: Получение статуса профиля

Пример 2: Отправка текстового сообщения

Пример 3: Отправка картинки (Base64)

🔧 12. Частые проблемы и решения

❌ Ошибка 401 Unauthorized

⚠️ Ошибка 400 Bad Request

🔍 Ошибка 404 Not Found

📱 Сообщение отправлено (200), но не доходит

🔄 Профиль постоянно разлогинивается

📖 13. Глоссарий терминов

✍️ 14. Проверь себя! Финальный тест