goflow-whatsapp

n8n community node for GoFlow WhatsApp — receive incoming messages and send text, media, mentions, typing and read receipts via the GoFlow API.

Package Information

Released: 4 mo ago
Downloads: 22 weekly / 714 monthly
Latest Version: 1.1.0
Author: GoFlow

Documentation

n8n-nodes-goflow-whatsapp

Community-нода n8n для GoFlow WhatsApp — приём и отправка сообщений WhatsApp через GoFlow API на собственной инфраструктуре.

Ноды

GoFlow WhatsApp Trigger

Запускает сценарий при входящем событии. Сам регистрирует ваш webhook-адрес у номера при активации и снимает при деактивации.

  • События: Сообщения · Реакции · Звонки · Подключение/отключение
  • Restrictions: все чаты / только личка / только группы
  • Ignore From Me — отбрасывать свои исходящие
  • Выдаёт разобранные плоские поля: chat_id, sender, sender_name, is_group, group_name, message_type, text, media_url, mentions, quoted, latitude/longitude, contact_name, emoji и др. + instance, api_key, raw.
  • Для звонков (событие Call): caller (номер звонящего, он же chat_id), caller_resolved (true = реальный номер; false = WhatsApp скрыл и восстановить не удалось), caller_lid (технический ID для трассировки), call_id, status (offer→ringing→reject/terminate), is_video, is_group, timestamp.
    • Как ловить звонок: «входящий звонок» → status == "offer"; «пропущенный/отклонённый» → status = reject/terminate. Один звонок присылает несколько событий с одним call_id — фильтруйте по status. Требует тумблер «Звонки» в настройках номера (по умолчанию выключен).

GoFlow WhatsApp

Действия:

Operation Что делает
Send Text Текстовое сообщение
Send Media Фото/видео/аудио/документ — по URL или бинарём из предыдущей ноды
Send With Mention В группу с @номер или @all
Download Media Скачать входящий файл по message_id (с ретраями)
Typing Индикатор «печатает…» (с задержкой и пульсацией)
Mark as Read Отметить сообщение прочитанным (с задержкой)

API Key Override в каждой операции — можно подставить {{$json.api_key}} из Trigger, чтобы один сценарий работал на несколько номеров.

Credentials

Поле Описание
API Key Ключ номера (X-API-Key) из кабинета, модуль «Вебхук / API»
Base URL https://my.goflow.kz (меняйте только при своём домене)

Установка

В n8n: Settings → Community Nodes → Install → n8n-nodes-goflow-whatsapp.

Сборка из исходников

npm install
npm run build

Документация API: https://my.goflow.kz/docs

License

MIT

Discussion