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ă 14 categorii de resurse cu 138 de operațiuni:
- Mesaje: Trimite 38 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
- Etichetă: Creează, editează și șterge etichete, etichetează chaturi
- Prezență: Citește și trimite starea online, scrie și înregistrează
- Catalog: Produse, colecții, comenzi și profil de business
- Grup: Creează grupuri, gestionează membri, administratori, setări, invitații, cereri de aderare
- Comunitate: Creează comunități, gestionează membri, administratori și subgrupuri
- Canal: Creează canale, publică, caută, urmărește și citește statistici
- Story: Publică story-uri, vezi cine le-a văzut și gestionează confidențialitatea
- 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ă 38 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 |
Delete Profile Image | Șterge poza de profil a contului tău WhatsApp |
Get Blocked Contacts | Listează contactele blocate |
Add Contact | Adaugă un contact în agenda telefonului |
Edit Contact | Editează un contact salvat |
Remove Contact | Șterge un contact din agendă |
LID to Phone | Transformă un identificator @lid în număr de telefon |
Phone to LID | Transformă un număr de telefon în identificatorul @lid |
Phone to Username | Obține numele de utilizator WhatsApp al unui număr |
Username to Phone | Transformă un nume de utilizator WhatsApp în număr de telefon |
Get Profile Name | Obține numele de profil al numărului tău |
Set Profile Name | Schimbă numele de profil al numărului tău |
Get Profile About | Obține textul „Despre” al numărului tău sau al unui contact |
Set Profile About | Setează textul „Despre” al numărului tău |
Get Profile Username | Obține numele de utilizator WhatsApp al numărului tău |
Set Profile Username | Setează numele de utilizator WhatsApp al numărului tău |
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 |
Set Disappearing Messages | Setează temporizatorul mesajelor temporare al unei conversații (oprit, 24h, 7 zile, 90 zile) |
Operațiuni cu etichete
| Operațiune | Descriere |
|---|---|
Get Labels | Listează toate etichetele numărului |
Get Labeled Chats | Listează chaturile cu o etichetă |
Get Label Colors | Listează culorile de etichetă disponibile |
Create Label | Creează o etichetă nouă |
Edit Label | Redenumește o etichetă sau schimbă-i culoarea |
Delete Labels | Șterge etichete din contul WhatsApp |
Add Label to Chat | Adaugă o etichetă la un chat |
Remove Label from Chat | Elimină o etichetă dintr-un chat |
Operațiuni de prezență
| Operațiune | Descriere |
|---|---|
Get Presence | Obține starea online/scrie a unui contact |
Subscribe Presence | Abonează-te la actualizările de prezență ale unui contact |
Send Presence | Trimite starea scrie, înregistrează sau online într-un chat |
Operațiuni de catalog
| Operațiune | Descriere |
|---|---|
Get Products | Listează produsele din catalogul numărului tău sau al unui contact |
Get Product | Obține un produs după ID |
Add Product | Adaugă un produs în catalog |
Edit Product | Editează un produs din catalog |
Remove Product | Elimină un produs din catalog |
Add Product Image | Adaugă o imagine la un produs |
Remove Product Image | Elimină o imagine de la un produs |
Get Collections | Listează colecțiile de produse |
Get Collection | Obține o colecție cu produsele ei |
Add Collection | Creează o colecție de produse |
Edit Collection | Redenumește sau actualizează o colecție |
Remove Collection | Șterge o colecție |
Add Collection Products | Adaugă produse într-o colecție |
Remove Collection Products | Elimină produse dintr-o colecție |
Get Orders | Listează comenzile primite cât sesiunea este activă |
Get Order | Obține o comandă cu articolele ei |
Get Business Profile | Obține profilul de business al numărului tău sau al unui contact |
Set Business Profile | Actualizează profilul de business al numărului tău |
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 |
Accept Invite V4 | Acceptă o invitație de grup (V4) primită prin webhook |
Operațiuni de comunitate
| Operațiune | Descriere |
|---|---|
Create Community | Creează o comunitate nouă |
Get Communities | Listează toate comunitățile cu subgrupurile lor |
Get Community | Obține o comunitate |
Add Participants | Adaugă membri într-o comunitate |
Remove Participant | Elimină un membru dintr-o comunitate |
Promote Admin | Promovează un membru ca administrator al comunității |
Demote Admin | Retrogradează un administrator al comunității |
Add Sub-Groups | Leagă grupuri existente de o comunitate |
Remove Sub-Groups | Dezleagă grupuri de o comunitate |
Revoke Invite | Revocă și regenerează linkul de invitație al comunității |
Get Unjoined Sub-Groups | Listează subgrupurile la care nu te-ai alăturat încă |
Join Sub-Group | Alătură-te unui subgrup al unei comunități |
Deactivate Community | Dezactivează o comunitate (ireversibil) |
Operațiuni de canal
| Operațiune | Descriere |
|---|---|
Create Channel | Creează un canal nou |
Get Channels | Listează canalele pe care le deții sau le urmărești |
Get Channel | Obține un canal |
Delete Channel | Șterge un canal pe care îl deții |
Set Channel Config | Actualizează numele, descrierea sau imaginea canalului |
Get Invite Code | Obține linkul de invitație al unui canal |
Search by Country | Descoperă canale după codul țării |
Search by Text | Caută canale după text |
Get Channel Messages | Citește mesajele unui canal |
Subscribe | Urmărește un canal |
Unsubscribe | Nu mai urmări un canal |
Subscribe by Invite Code | Urmărește un canal folosind codul de invitație |
Unsubscribe by Invite Code | Nu mai urmări un canal folosind codul de invitație |
Get Info by Invite Code | Obține informații despre canal dintr-un cod de invitație |
Get Statistics | Obține statisticile de urmăritori și acoperire ale unui canal |
Demote Admin | Retrage drepturile de administrator ale unui canal |
Accept Admin Invite | Acceptă o invitație de a deveni administrator al canalului |
Revoke Admin Invite | Revocă o invitație de administrator de canal în așteptare |
Operațiuni cu story-uri
| Operațiune | Descriere |
|---|---|
Create Story | Publică un story text, media sau audio |
Get My Stories | Listează story-urile tale cu cei care le-au văzut |
Get Contacts Stories | Listează story-urile publicate de contactele tale |
Get Story Privacy | Află cine poate vedea story-urile tale |
Set Story Privacy | Setează cine poate vedea story-urile tale |
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 |
Get Calls | Listează istoricul apelurilor |
Get Call | Obține un apel după ID |
Start Call | Pornește un apel de atenționare care sună și se încheie automat (fără audio) |
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 |
Get New Chat Limit | Obține limita de chaturi noi aplicată de WhatsApp numărului |
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 138 de operațiuni în 14 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, Label, Presence, Business Catalog, Group, Community, Channel, Story, 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.