Integrare Maytapi n8n pentru WhatsApp API | Automatizarea fluxurilor de lucru

Maytapi Integrare n8n pentru WhatsApp API

Noduri personalizate oficiale Maytapi pentru platforma de automatizare a fluxurilor de lucru n8n. Automatizează mesajele WhatsApp, gestionează contacte, grupuri, sesiuni și multe altele cu fluxuri de lucru vizuale drag-and-drop. Conectează WhatsApp la peste 400 de aplicații și servicii fără a scrie cod.

Ce este n8n?

n8n este o platformă puternică de automatizare a fluxurilor de lucru, open-source, care îți permite să conectezi diferite aplicații și servicii în mod vizual. Construiește automatizări complexe folosind o interfață drag-and-drop fără a scrie cod.

Cu nodurile oficiale Maytapi pentru n8n, poți integra WhatsApp în orice flux de lucru -- trimite mesaje, gestionează grupuri, administrează contacte, primește evenimente webhook în timp real și automatizează întregul canal de comunicare WhatsApp.

Configurare rapidă

Instalează prin n8n Community Nodes sau npm:

npm install @maytapi/n8n-nodes-maytapi

Credențiale necesare:

Product ID: Din Consola Maytapi
API Token: Cheia ta x-maytapi-key
Phone ID: (Opțional) Instanța implicită WhatsApp

Cum funcționează

Instalează pachetul

În n8n, accesează Settings → Community Nodes → Install și introdu @maytapi/n8n-nodes-maytapi. Sau instalează manual prin npm și repornește n8n.

Adaugă credențialele

Creează o nouă credențială Maytapi API cu Product ID și API Token din Consola Maytapi. Opțional, setează un Phone ID implicit.

Construiește fluxuri de lucru

Adaugă nodurile Maytapi sau Maytapi Trigger în fluxurile tale de lucru și conectează-le cu peste 400 de aplicații și servicii din n8n.

Două noduri puternice

Pachetul include două noduri dedicate care acoperă întreaga Maytapi WhatsApp API.

Nodul Maytapi (Acțiuni)

Execută operațiuni WhatsApp în fluxurile tale de lucru. Suportă 9 categorii de resurse cu peste 50 de operațiuni:

Mesaje: Trimite peste 23 de tipuri de mesaje (text, media, poll, locație, vcard, butoane, listă, sticker, reacție, redirecționare, ștergere, editare și altele)
Contact: Obține contacte, verifică numere de telefon, blochează/deblochează, imagini de profil
Chat: Listează conversații, arhivează, fixează, dezactivează sunetul, favorite, șterge istoricul
Grup: Creează grupuri, gestionează membri, administratori, setări, invitații, cereri de aderare
Coadă: Listează, obține și golește cozile de mesaje
Apel: Respinge apeluri, creează linkuri de apel vocal/video
Cont: Gestionează telefoane, webhook-uri, jurnale, informații despre produs
Sesiune: Verifică starea, obține cod QR, deconectare, conectare cu număr de telefon
Control sesiune: Redistribuire, resetare din fabrică, obține/setează configurația

Nodul Maytapi Trigger (Webhook-uri)

Primește evenimente WhatsApp în timp real pentru a declanșa fluxurile tale de lucru. Selectează evenimentele pe care dorești să le asculți:

Evenimente mesaje: Mesaje noi primite/trimise cu metadate complete (tip, subtip, expeditor, text, media, marcaj temporal)
Evenimente ACK: Modificări ale stării de livrare a mesajelor (trimis, livrat, citit)
Evenimente grup: Intrări de membri, plecări, invitații, eliminări, modificări de setări
Evenimente apel: Apeluri primite, efectuate, pierdute, respinse
Evenimente story: Story-uri noi postate de contacte

Webhook-urile sunt configurate automat când activezi fluxul de lucru și sunt eliminate când îl dezactivezi.

Operațiuni disponibile

Lista completă a operațiunilor disponibile în Nodul Maytapi, grupate pe resurse.

Operațiuni mesaje

Operațiune	Descriere
`Send Message`	Trimite mesaje către orice chat. Suportă peste 23 de tipuri de mesaje: text, media, poll, locație, vcard, contact, link, produs, butoane, listă, sticker, video scurt, redirecționare, ștergere, reacție, eliminare reacție, editare, invitație de grup, fixare mesaj, marcare cu stea, creare eveniment, răspuns text la story și răspuns media la story.
`Get Message`	Obține informații despre un mesaj specific după ID
`Get Messages`	Obține mesaje dintr-o conversație cu paginare, filtru de autor și filtru fromMe

Operațiuni contacte

Operațiune	Descriere
`Get Contacts`	Listează toate contactele WhatsApp
`Get Contact`	Obține informații despre un contact specific
`Check Phones`	Verifică dacă numerele de telefon sunt înregistrate pe WhatsApp
`Block Contact`	Blochează sau deblochează un contact
`Get Profile Image`	Obține imaginea de profil a unui contact sau grup
`Set Profile Image`	Setează imaginea de profil a contului tău WhatsApp

Operațiuni chat

Operațiune	Descriere
`Get Conversations`	Listează toate conversațiile/chat-urile cu paginare
`Get Conversation`	Obține detaliile unei conversații specifice cu mesaje
`Favorite Chat`	Adaugă sau elimină o conversație din favorite
`Pin Chat`	Fixează sau anulează fixarea unei conversații
`Archive Chat`	Arhivează sau dezarhivează o conversație
`Mute Chat`	Dezactivează sau activează sunetul unei conversații (8 ore, 1 săptămână sau permanent)
`Clear Chat`	Șterge toate mesajele dintr-o conversație

Operațiuni grup

Operațiune	Descriere
`Create Group`	Creează un nou grup WhatsApp cu participanți, mesaj de invitație opțional și imagine de profil
`Get Groups`	Listează toate grupurile cu încărcare opțională a participanților, sortare, linkuri de invitație și paginare
`Get Group`	Obține informații despre un grup specific cu generare opțională de link de invitație
`Set Group Image`	Setează imaginea de profil a grupului
`Delete Group Image`	Șterge imaginea de profil a grupului
`Add Participants`	Adaugă membri într-un grup cu invitație opțională
`Remove Participant`	Elimină un membru dintr-un grup
`Promote Admin`	Promovează un participant la rang de administrator
`Demote Admin`	Retrogradează un administrator la rang de participant
`Set Group Config`	Configurează setările grupului: permisiuni, mesaje care dispar, aprobare adăugare membri, nume, descriere
`Accept Invite`	Acceptă o invitație de grup prin codul de invitație
`Revoke Invite`	Revocă și regenerează linkul de invitație al grupului
`Leave Group`	Părăsește un grup WhatsApp
`Get Approval Requests`	Listează cererile de aderare în așteptare pentru un grup
`Approve Join Requests`	Aprobă cererile de aderare în așteptare
`Reject Join Requests`	Respinge cererile de aderare în așteptare
`Get Group Info by Invite Code`	Obține informații despre grup folosind codul de invitație

Operațiuni coadă

Operațiune	Descriere
`List Queues`	Listează toate cozile de mesaje ale telefoanelor
`Get Queue`	Obține coada de mesaje pentru un telefon specific
`Clear Queue`	Golește coada de mesaje a telefonului

Operațiuni apel

Operațiune	Descriere
`Reject Call`	Respinge un apel primit (callId obținut din notificarea webhook)
`Create Call Link`	Creează un link partajabil de apel pentru apeluri vocale sau video cu marcaj temporal programat

Operațiuni cont

Operațiune	Descriere
`Get Product Info`	Obține informații despre produs
`Add Phone`	Adaugă un telefon nou la produs cu număr de telefon opțional
`List Phones`	Listează toate telefoanele înregistrate
`Set Webhook`	Configurează URL-ul webhook pentru produs
`Set ACK Preference`	Activează sau dezactivează notificările de confirmare prin webhook
`Get Logs`	Obține jurnalele pentru toate telefoanele
`Get Phone Logs`	Obține jurnalele pentru un telefon specific

Operațiuni sesiune

Operațiune	Descriere
`Get Status`	Verifică starea conexiunii sesiunii
`Get Screen`	Obține o captură de ecran a sesiunii curente (returnează imagine binară)
`Get QR Code`	Obține codul QR pentru asocierea telefonului (returnează imagine binară)
`Logout`	Deconectează sesiunea WhatsApp
`Connect with Phone Number`	Conectează-te folosind numărul de telefon în loc de codul QR

Operațiuni control sesiune

Operațiune	Descriere
`Redeploy`	Redistribuie instanța Docker pentru a reporni sesiunea
`Factory Reset`	Resetare din fabrică a telefonului la starea inițială
`Get Config`	Obține configurația specifică telefonului
`Set Config`	Setează URL-ul webhook specific telefonului și setările de livrare ACK

Evenimente Webhook Trigger

Tip eveniment	Descriere
`Message`	Mesaje noi primite/trimise cu metadate complete: tip mesaj, subtip, număr expeditor, nume expeditor, destinatar, text mesaj, ID mesaj, marcaj temporal, detalii conversație
`ACK`	Modificări ale stării de livrare a mesajelor: trimis, livrat, citit -- cu ID mesaj și marcaj temporal
`Group`	Evenimente membri grup: intrări, plecări, invitații, eliminări, modificări de setări -- cu ID grup, nume, tip acțiune și detalii participant
`Call`	Evenimente apel: apeluri primite, efectuate, pierdute, respinse -- cu ID apel, stare și detalii apelant
`Story`	Evenimente story: story-uri noi postate de contacte -- cu ID story, expeditor, tip story și conținut

Întrebări frecvente

Cum instalez nodurile Maytapi n8n?

Accesează Settings → Community Nodes → Install în instanța ta n8n și caută @maytapi/n8n-nodes-maytapi. Sau instalează manual prin npm: npm install @maytapi/n8n-nodes-maytapi și repornește n8n.

Ce credențiale am nevoie?

Ai nevoie de Product ID și API Token din Consola Maytapi. Opțional, poți specifica un Phone ID implicit pentru instanța ta WhatsApp.

Pot folosi mai multe numere WhatsApp?

Da! Poți seta un Phone ID implicit în credențiale sau îl poți suprascrie per nod. Opțiunea "Phone ID Source" îți permite să alegi între credențiale sau Phone ID personalizat pentru fiecare operațiune.

Cum funcționează webhook-urile cu n8n?

Nodul Maytapi Trigger configurează automat webhook-urile cu Maytapi când activezi fluxul de lucru. Poți selecta ce evenimente să primești (mesaje, ACK, grupuri, apeluri, story-uri). Webhook-ul este eliminat automat când dezactivezi fluxul de lucru.

Ce tipuri de mesaje pot trimite?

Operațiunea Send Message suportă toate tipurile de mesaje Maytapi: text, imagini, videoclipuri, documente, audio, locație, carduri de contact, stickere, sondaje, reacții, butoane, mesaje cu listă, video scurt, redirecționare, ștergere, editare, fixare și altele.

Este gratuită integrarea n8n?

Pachetul de noduri Maytapi n8n este gratuit și open source. Ai nevoie doar de un abonament Maytapi activ pentru a utiliza WhatsApp API. Toate planurile Maytapi includ acces complet la API fără costuri suplimentare pentru integrarea n8n.