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 по умолчанию

Как это работает

1
Установите пакет

В n8n перейдите в Settings → Community Nodes → Install и введите @maytapi/n8n-nodes-maytapi. Или установите вручную через npm и перезапустите n8n.

2
Добавьте учётные данные

Создайте новые учётные данные Maytapi API с вашим Product ID и API Token из Консоли Maytapi. При необходимости укажите Phone ID по умолчанию.

3
Создавайте рабочие процессы

Добавьте узлы 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/{productId}

Аутентификация:

  • Заголовок: x-maytapi-key
  • Product ID в пути URL
  • Необязательный параметр Phone ID для каждой операции

Ресурсы:

Сообщения, Контакты, Чаты, Группы, Очереди, Звонки, Аккаунт, Сессия, Управление сессией

Готовы усилить вашу коммуникацию в WhatsApp?

Раскройте мощные возможности для бизнес-сообщений и автоматизации с нашим API для 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.

Изучите WhatsApp API для вашего клиента

Раскройте полный потенциал WhatsApp API с неограниченными функциями Индивидуально для успеха вашего бренда

Свяжитесь с нами, чтобы стать нашим партнером. Отправьте электронное письмо, чтобы обсудить любые условия, соглашения и цены.