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 в ваших рабочих процессах. Поддерживает 14 категорий ресурсов со 138 операциями:
- Сообщения: Отправка 38 типов сообщений (текст, медиа, опрос, геолокация, vcard, кнопки, список, стикер, реакция, пересылка, удаление, редактирование и другие)
- Контакты: Получение контактов, проверка номеров телефонов, блокировка/разблокировка, изображения профилей
- Чаты: Список бесед, архивирование, закрепление, отключение звука, избранное, очистка истории
- Метки: Создание, изменение и удаление меток, пометка чатов
- Присутствие: Чтение и отправка статусов онлайн, печатает, записывает
- Каталог: Товары, коллекции, заказы и бизнес-профиль
- Группы: Создание групп, управление участниками, администраторами, настройками, приглашениями, запросами на вступление
- Сообщества: Создание сообществ, управление участниками, админами и подгруппами
- Каналы: Создание каналов, публикации, поиск, подписка и статистика
- Истории: Публикация историй, просмотревшие и настройки приватности
- Очередь: Просмотр, получение и очистка очередей сообщений
- Звонки: Отклонение звонков, создание ссылок для голосовых/видеозвонков
- Аккаунт: Управление телефонами, webhook, логами, информацией о продукте
- Сессия: Проверка статуса, получение QR-кода, выход из системы, подключение по номеру телефона
- Управление сессией: Переразвёртывание, сброс к заводским настройкам, получение/установка конфигурации
Узел Maytapi Trigger (Webhook)
Получайте события WhatsApp в реальном времени для запуска рабочих процессов. Выберите, какие события отслеживать:
- События сообщений: Новые входящие/исходящие сообщения с полными метаданными (тип, подтип, отправитель, текст, медиа, временная метка)
- События ACK: Изменения статуса доставки сообщений (отправлено, доставлено, прочитано)
- События групп: Вступление участников, выход, приглашения, удаление, изменение настроек
- События звонков: Входящие, исходящие, пропущенные, отклонённые звонки
- События историй: Новые истории, опубликованные контактами
Webhook автоматически настраиваются при активации рабочего процесса и удаляются при его деактивации.
Доступные операции
Полный список операций, доступных в узле Maytapi, сгруппированных по ресурсам.
Операции с сообщениями
| Операция | Описание |
|---|---|
Send Message | Отправляйте сообщения в любой чат. Поддерживает 38 типов сообщений: текст, медиа, опрос, геолокация, vcard, контакт, ссылка, товар, кнопки, список, стикер, короткое видео, пересылка, удаление, реакция, снятие реакции, редактирование, приглашение в группу, закрепление сообщения, избранное, создание события, текстовый ответ на историю и медиа-ответ на историю. |
Get Message | Получение информации о конкретном сообщении по ID |
Get Messages | Получение сообщений из беседы с пагинацией, фильтром по автору и фильтром fromMe |
Операции с контактами
| Операция | Описание |
|---|---|
Get Contacts | Список всех контактов WhatsApp |
Get Contact | Получение информации о конкретном контакте |
Check Phones | Проверка, зарегистрированы ли номера телефонов в WhatsApp |
Block Contact | Блокировка или разблокировка контакта |
Get Profile Image | Получение аватара контакта или группы |
Set Profile Image | Установка аватара вашего аккаунта WhatsApp |
Delete Profile Image | Удалить фото профиля аккаунта WhatsApp |
Get Blocked Contacts | Список заблокированных контактов |
Add Contact | Добавить контакт в адресную книгу телефона |
Edit Contact | Изменить сохранённый контакт |
Remove Contact | Удалить контакт из адресной книги |
LID to Phone | Преобразовать @lid в номер телефона |
Phone to LID | Преобразовать номер телефона в @lid |
Phone to Username | Получить имя пользователя WhatsApp по номеру |
Username to Phone | Преобразовать имя пользователя WhatsApp в номер |
Get Profile Name | Получить имя профиля вашего номера |
Set Profile Name | Изменить имя профиля вашего номера |
Get Profile About | Получить текст «О себе» вашего номера или контакта |
Set Profile About | Задать текст «О себе» вашего номера |
Get Profile Username | Получить имя пользователя WhatsApp вашего номера |
Set Profile Username | Задать имя пользователя WhatsApp вашего номера |
Операции с чатами
| Операция | Описание |
|---|---|
Get Conversations | Список всех бесед/чатов с пагинацией |
Get Conversation | Получение деталей конкретной беседы с сообщениями |
Favorite Chat | Добавление или удаление беседы из избранного |
Pin Chat | Закрепление или открепление беседы |
Archive Chat | Архивирование или разархивирование беседы |
Mute Chat | Отключение или включение звука беседы (8 часов, 1 неделя или навсегда) |
Clear Chat | Очистка всех сообщений в беседе |
Set Disappearing Messages | Задать таймер исчезающих сообщений чата (выкл, 24 ч, 7 дней, 90 дней) |
Операции с метками
| Операция | Описание |
|---|---|
Get Labels | Список всех меток номера |
Get Labeled Chats | Список чатов с меткой |
Get Label Colors | Список доступных цветов меток |
Create Label | Создать новую метку |
Edit Label | Переименовать метку или изменить её цвет |
Delete Labels | Удалить метки из аккаунта WhatsApp |
Add Label to Chat | Добавить метку к чату |
Remove Label from Chat | Убрать метку с чата |
Операции присутствия
| Операция | Описание |
|---|---|
Get Presence | Получить статус онлайн/печатает контакта |
Subscribe Presence | Подписаться на обновления присутствия контакта |
Send Presence | Отправить статус печатает, записывает или онлайн в чат |
Операции с каталогом
| Операция | Описание |
|---|---|
Get Products | Список товаров каталога вашего номера или контакта |
Get Product | Получить товар по ID |
Add Product | Добавить товар в каталог |
Edit Product | Изменить товар каталога |
Remove Product | Удалить товар из каталога |
Add Product Image | Добавить изображение товара |
Remove Product Image | Удалить изображение товара |
Get Collections | Список коллекций товаров |
Get Collection | Получить коллекцию с товарами |
Add Collection | Создать коллекцию товаров |
Edit Collection | Переименовать или обновить коллекцию |
Remove Collection | Удалить коллекцию |
Add Collection Products | Добавить товары в коллекцию |
Remove Collection Products | Удалить товары из коллекции |
Get Orders | Список заказов, полученных во время сессии |
Get Order | Получить заказ с позициями |
Get Business Profile | Получить бизнес-профиль вашего номера или контакта |
Set Business Profile | Обновить бизнес-профиль вашего номера |
Операции с группами
| Операция | Описание |
|---|---|
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 | Получение информации о группе по коду приглашения |
Accept Invite V4 | Принять приглашение в группу (V4), полученное через webhook |
Операции с сообществами
| Операция | Описание |
|---|---|
Create Community | Создать новое сообщество |
Get Communities | Список всех сообществ с подгруппами |
Get Community | Получить сообщество |
Add Participants | Добавить участников в сообщество |
Remove Participant | Удалить участника из сообщества |
Promote Admin | Назначить участника администратором сообщества |
Demote Admin | Снять администратора сообщества |
Add Sub-Groups | Привязать существующие группы к сообществу |
Remove Sub-Groups | Отвязать группы от сообщества |
Revoke Invite | Отозвать и создать заново ссылку-приглашение сообщества |
Get Unjoined Sub-Groups | Список подгрупп, к которым вы ещё не присоединились |
Join Sub-Group | Присоединиться к подгруппе сообщества |
Deactivate Community | Деактивировать сообщество (необратимо) |
Операции с каналами
| Операция | Описание |
|---|---|
Create Channel | Создать новый канал |
Get Channels | Список каналов, которыми вы владеете или на которые подписаны |
Get Channel | Получить канал |
Delete Channel | Удалить ваш канал |
Set Channel Config | Обновить название, описание или изображение канала |
Get Invite Code | Получить ссылку-приглашение канала |
Search by Country | Поиск каналов по коду страны |
Search by Text | Поиск каналов по тексту |
Get Channel Messages | Читать сообщения канала |
Subscribe | Подписаться на канал |
Unsubscribe | Отписаться от канала |
Subscribe by Invite Code | Подписаться на канал по коду приглашения |
Unsubscribe by Invite Code | Отписаться от канала по коду приглашения |
Get Info by Invite Code | Получить информацию о канале по коду приглашения |
Get Statistics | Получить статистику подписчиков и охвата канала |
Demote Admin | Снять права администратора канала |
Accept Admin Invite | Принять приглашение стать администратором канала |
Revoke Admin Invite | Отозвать ожидающее приглашение администратора канала |
Операции с историями
| Операция | Описание |
|---|---|
Create Story | Опубликовать текстовую, медиа- или аудиоисторию |
Get My Stories | Список ваших историй с просмотревшими |
Get Contacts Stories | Список историй ваших контактов |
Get Story Privacy | Узнать, кто видит ваши истории |
Set Story Privacy | Задать, кто видит ваши истории |
Операции с очередями
| Операция | Описание |
|---|---|
List Queues | Список всех очередей сообщений телефонов |
Get Queue | Получение очереди сообщений для конкретного телефона |
Clear Queue | Очистка очереди сообщений телефона |
Операции со звонками
| Операция | Описание |
|---|---|
Reject Call | Отклонение входящего звонка (callId получается из webhook-уведомления) |
Create Call Link | Создание ссылки для голосового или видеозвонка с запланированным временем |
Get Calls | Список истории звонков |
Get Call | Получить звонок по ID |
Start Call | Запустить звонок-уведомление, который звонит и завершается сам (без аудио) |
Операции с аккаунтом
| Операция | Описание |
|---|---|
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-кода |
Get New Chat Limit | Получить лимит новых чатов, применяемый WhatsApp к номеру |
Операции управления сессией
| Операция | Описание |
|---|---|
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 с 138 операциями в 14 категориях ресурсов
- 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.