Maytapi
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-maytapiCredenț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 |
De ce să folosești nodurile Maytapi n8n?
Adu întreaga putere a WhatsApp API în fluxurile tale de lucru n8n cu noduri create special.
- Acoperire completă a API cu peste 50 de operațiuni în 9 categorii de resurse
- Declanșatoare webhook în timp real pentru mesaje, stare de livrare, evenimente de grup, apeluri și story-uri
- Nu necesită programare -- constructor vizual de fluxuri de lucru drag-and-drop
- Flexibilitate Phone ID -- folosește implicit sau personalizat per operațiune
- Gestionare integrată a erorilor cu logică de reîncercare și mesaje de eroare detaliate
- Conectează WhatsApp la peste 400 de aplicații: CRM-uri, baze de date, email, Slack și altele
Automatizează comunicarea ta WhatsApp cu instrumentele pe care le folosești deja.
Detalii tehnice
Numele pachetului:
@maytapi/n8n-nodes-maytapi
Endpoint API:
https://api.maytapi.com/api/{pid}
Autentificare:
- Header:
x-maytapi-key - Product ID în calea URL-ului
- Parametru opțional Phone ID per operațiune
Resurse:
Message, Contact, Chat, Group, Queue, Call, Account, Session, Session Control
Ești gata să îți potențezi comunicarea pe WhatsApp?
Dezvăluie caracteristici puternice pentru mesageria de business și automatizare cu API-ul nostru pentru WhatsApp
Perfect pentru afaceri, dezvoltatori și utilizatori avansați
Î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.