Maytapi
Maytapi Интеграция n8n для WhatsApp API
Официальные пользовательские узлы Maytapi для платформы автоматизации рабочих процессов n8n. Автоматизируйте обмен сообщениями в WhatsApp, управляйте контактами, группами, сессиями и многим другим с помощью визуальных рабочих процессов drag-and-drop. Подключите WhatsApp к 400+ приложениям и сервисам без написания кода.
Что такое n8n?
n8n — это мощная платформа автоматизации рабочих процессов с открытым исходным кодом, которая позволяет визуально соединять различные приложения и сервисы. Создавайте сложные автоматизации с помощью интерфейса drag-and-drop без написания кода.
С помощью официальных узлов Maytapi для n8n вы можете интегрировать WhatsApp в любой рабочий процесс — отправлять сообщения, управлять группами, работать с контактами, получать события webhook в реальном времени и автоматизировать весь конвейер коммуникаций WhatsApp.
Быстрая настройка
Установите через n8n Community Nodes или npm:
npm install @maytapi/n8n-nodes-maytapiНеобходимые учётные данные:
- Product ID: Из Консоли Maytapi
- API Token: Ваш x-maytapi-key
- Phone ID: (Необязательно) Экземпляр WhatsApp по умолчанию
Как это работает
Установите пакет
В n8n перейдите в Settings → Community Nodes → Install и введите @maytapi/n8n-nodes-maytapi. Или установите вручную через npm и перезапустите n8n.
Добавьте учётные данные
Создайте новые учётные данные Maytapi API с вашим Product ID и API Token из Консоли Maytapi. При необходимости укажите Phone ID по умолчанию.
Создавайте рабочие процессы
Добавьте узлы Maytapi или Maytapi Trigger в свои рабочие процессы и соедините их с 400+ другими приложениями и сервисами в n8n.
Два мощных узла
Пакет включает два специализированных узла, охватывающих полный Maytapi WhatsApp API.
Узел Maytapi (Действия)
Выполняйте операции WhatsApp в ваших рабочих процессах. Поддерживает 9 категорий ресурсов с 50+ операциями:
- Сообщения: Отправка 23+ типов сообщений (текст, медиа, опрос, геолокация, vcard, кнопки, список, стикер, реакция, пересылка, удаление, редактирование и другие)
- Контакты: Получение контактов, проверка номеров телефонов, блокировка/разблокировка, изображения профилей
- Чаты: Список бесед, архивирование, закрепление, отключение звука, избранное, очистка истории
- Группы: Создание групп, управление участниками, администраторами, настройками, приглашениями, запросами на вступление
- Очередь: Просмотр, получение и очистка очередей сообщений
- Звонки: Отклонение звонков, создание ссылок для голосовых/видеозвонков
- Аккаунт: Управление телефонами, webhook, логами, информацией о продукте
- Сессия: Проверка статуса, получение QR-кода, выход из системы, подключение по номеру телефона
- Управление сессией: Переразвёртывание, сброс к заводским настройкам, получение/установка конфигурации
Узел Maytapi Trigger (Webhook)
Получайте события WhatsApp в реальном времени для запуска рабочих процессов. Выберите, какие события отслеживать:
- События сообщений: Новые входящие/исходящие сообщения с полными метаданными (тип, подтип, отправитель, текст, медиа, временная метка)
- События ACK: Изменения статуса доставки сообщений (отправлено, доставлено, прочитано)
- События групп: Вступление участников, выход, приглашения, удаление, изменение настроек
- События звонков: Входящие, исходящие, пропущенные, отклонённые звонки
- События историй: Новые истории, опубликованные контактами
Webhook автоматически настраиваются при активации рабочего процесса и удаляются при его деактивации.
Доступные операции
Полный список операций, доступных в узле Maytapi, сгруппированных по ресурсам.
Операции с сообщениями
| Операция | Описание |
|---|---|
Send Message | Отправляйте сообщения в любой чат. Поддерживает 23+ типов сообщений: текст, медиа, опрос, геолокация, vcard, контакт, ссылка, товар, кнопки, список, стикер, короткое видео, пересылка, удаление, реакция, снятие реакции, редактирование, приглашение в группу, закрепление сообщения, избранное, создание события, текстовый ответ на историю и медиа-ответ на историю. |
Get Message | Получение информации о конкретном сообщении по ID |
Get Messages | Получение сообщений из беседы с пагинацией, фильтром по автору и фильтром fromMe |
Операции с контактами
| Операция | Описание |
|---|---|
Get Contacts | Список всех контактов WhatsApp |
Get Contact | Получение информации о конкретном контакте |
Check Phones | Проверка, зарегистрированы ли номера телефонов в WhatsApp |
Block Contact | Блокировка или разблокировка контакта |
Get Profile Image | Получение аватара контакта или группы |
Set Profile Image | Установка аватара вашего аккаунта WhatsApp |
Операции с чатами
| Операция | Описание |
|---|---|
Get Conversations | Список всех бесед/чатов с пагинацией |
Get Conversation | Получение деталей конкретной беседы с сообщениями |
Favorite Chat | Добавление или удаление беседы из избранного |
Pin Chat | Закрепление или открепление беседы |
Archive Chat | Архивирование или разархивирование беседы |
Mute Chat | Отключение или включение звука беседы (8 часов, 1 неделя или навсегда) |
Clear Chat | Очистка всех сообщений в беседе |
Операции с группами
| Операция | Описание |
|---|---|
Create Group | Создание новой группы WhatsApp с участниками, необязательным приглашением и изображением профиля |
Get Groups | Список всех групп с опциональной загрузкой участников, сортировкой, ссылками-приглашениями и пагинацией |
Get Group | Получение информации о конкретной группе с опциональной генерацией ссылки-приглашения |
Set Group Image | Установка аватара группы |
Delete Group Image | Удаление аватара группы |
Add Participants | Добавление участников в группу с необязательным приглашением |
Remove Participant | Удаление участника из группы |
Promote Admin | Повышение участника до администратора |
Demote Admin | Понижение администратора до участника |
Set Group Config | Настройка параметров группы: разрешения, исчезающие сообщения, одобрение добавления участников, название, описание |
Accept Invite | Принятие приглашения в группу по коду приглашения |
Revoke Invite | Отзыв и повторная генерация ссылки-приглашения в группу |
Leave Group | Выход из группы WhatsApp |
Get Approval Requests | Список ожидающих запросов на вступление в группу |
Approve Join Requests | Одобрение ожидающих запросов на вступление |
Reject Join Requests | Отклонение ожидающих запросов на вступление |
Get Group Info by Invite Code | Получение информации о группе по коду приглашения |
Операции с очередями
| Операция | Описание |
|---|---|
List Queues | Список всех очередей сообщений телефонов |
Get Queue | Получение очереди сообщений для конкретного телефона |
Clear Queue | Очистка очереди сообщений телефона |
Операции со звонками
| Операция | Описание |
|---|---|
Reject Call | Отклонение входящего звонка (callId получается из webhook-уведомления) |
Create Call Link | Создание ссылки для голосового или видеозвонка с запланированным временем |
Операции с аккаунтом
| Операция | Описание |
|---|---|
Get Product Info | Получение информации о продукте |
Add Phone | Добавление нового телефона к продукту с необязательным номером телефона |
List Phones | Список всех зарегистрированных телефонов |
Set Webhook | Настройка URL webhook для продукта |
Set ACK Preference | Включение или отключение уведомлений о подтверждении через webhook |
Get Logs | Получение логов для всех телефонов |
Get Phone Logs | Получение логов для конкретного телефона |
Операции с сессиями
| Операция | Описание |
|---|---|
Get Status | Проверка статуса подключения сессии |
Get Screen | Получение скриншота текущего экрана сессии (возвращает бинарное изображение) |
Get QR Code | Получение QR-кода для привязки телефона (возвращает бинарное изображение) |
Logout | Отключение сессии WhatsApp |
Connect with Phone Number | Подключение по номеру телефона вместо QR-кода |
Операции управления сессией
| Операция | Описание |
|---|---|
Redeploy | Переразвёртывание экземпляра Docker для перезагрузки сессии |
Factory Reset | Сброс телефона к заводским настройкам |
Get Config | Получение конфигурации конкретного телефона |
Set Config | Установка URL webhook и настроек доставки ACK для конкретного телефона |
События Webhook Trigger
| Тип события | Описание |
|---|---|
Message | Новые входящие/исходящие сообщения с полными метаданными: тип сообщения, подтип, номер отправителя, имя отправителя, получатель, текст сообщения, ID сообщения, временная метка, детали беседы |
ACK | Изменения статуса доставки сообщений: отправлено, доставлено, прочитано — с ID сообщения и временной меткой |
Group | События участников группы: вступления, выходы, приглашения, удаления, изменения настроек — с ID группы, названием, типом действия и данными участника |
Call | События звонков: входящие, исходящие, пропущенные, отклонённые звонки — с ID звонка, статусом и данными звонящего |
Story | События историй: новые истории, опубликованные контактами — с ID истории, отправителем, типом истории и содержимым |
Почему стоит использовать узлы Maytapi n8n?
Раскройте всю мощь WhatsApp API в ваших рабочих процессах n8n с помощью специализированных узлов.
- Полное покрытие API с 50+ операциями в 9 категориях ресурсов
- Webhook-триггеры в реальном времени для сообщений, статусов доставки, событий групп, звонков и историй
- Программирование не требуется — визуальный конструктор рабочих процессов drag-and-drop
- Гибкость Phone ID — используйте значение по умолчанию или указывайте для каждой операции
- Встроенная обработка ошибок с логикой повторных попыток и подробными сообщениями об ошибках
- Подключите WhatsApp к 400+ приложениям: CRM, базы данных, email, Slack и другие
Автоматизируйте коммуникации в WhatsApp с помощью инструментов, которые вы уже используете.
Технические детали
Название пакета:
@maytapi/n8n-nodes-maytapi
Конечная точка API:
https://api.maytapi.com/api/{pid}
Аутентификация:
- Заголовок:
x-maytapi-key - Product ID в пути URL
- Необязательный параметр Phone ID для каждой операции
Ресурсы:
Сообщения, Контакты, Чаты, Группы, Очереди, Звонки, Аккаунт, Сессия, Управление сессией
Готовы усилить вашу коммуникацию в WhatsApp?
Раскройте мощные возможности для бизнес-сообщений и автоматизации с нашим API для WhatsApp
Идеально для бизнеса, разработчиков и продвинутых пользователей
Часто задаваемые вопросы
Как установить узлы Maytapi n8n?
Перейдите в Settings → Community Nodes → Install в вашем экземпляре n8n и найдите @maytapi/n8n-nodes-maytapi. Или установите вручную через npm: npm install @maytapi/n8n-nodes-maytapi и перезапустите n8n.
Какие учётные данные мне нужны?
Вам понадобятся Product ID и API Token из Консоли Maytapi. При необходимости вы можете указать Phone ID по умолчанию для вашего экземпляра WhatsApp.
Можно ли использовать несколько номеров WhatsApp?
Да! Вы можете задать Phone ID по умолчанию в учётных данных или переопределить его для каждого узла. Опция «Phone ID Source» позволяет выбрать между учётными данными или пользовательским Phone ID для каждой операции.
Как работают webhook с n8n?
Узел Maytapi Trigger автоматически настраивает webhook в Maytapi при активации рабочего процесса. Вы можете выбрать, какие события получать (сообщения, ACK, группы, звонки, истории). Webhook автоматически удаляется при деактивации рабочего процесса.
Какие типы сообщений можно отправлять?
Операция Send Message поддерживает все типы сообщений Maytapi: текст, изображения, видео, документы, аудио, геолокация, визитные карточки, стикеры, опросы, реакции, кнопки, списки, короткие видео, пересылка, удаление, редактирование, закрепление и многое другое.
Интеграция с n8n бесплатна?
Пакет узлов Maytapi n8n бесплатный и с открытым исходным кодом. Вам нужна только активная подписка Maytapi для использования WhatsApp API. Все тарифные планы Maytapi включают полный доступ к API без дополнительной платы за интеграцию с n8n.