Jurnalul de schimbări al WhatsApp API-ului

Maytapi Changelog

Anunțăm aici noile funcționalități și modificările pe care le-am făcut la WhatsApp API-ul

12.10.2026

Nou

Menționează pe toată lumea dintr-o dată - sendMessage acceptă acum @all, astfel încât un singur mesaj poate notifica toți membrii unui grup fără a enumera fiecare număr; vezi exemplul 'Mention Everyone Message'

Organizează quiz-uri în canalele tale WhatsApp - noul tip channel_quiz din sendMessage îți permite să publici o întrebare cu răspuns corect, iar getMessage / channel/getMessages returnează opțiunile, opțiunea corectă și numărul de voturi ca să poți urmări rezultatele

Participă la discuția de sub anunțurile tale - sendMessage poate acum posta comentarii la mesajele grupului de anunțuri al unei comunități (vezi exemplul 'Comment Message'), iar răspunsurile mesajelor includ replyCount și lista completă de comentarii

Etichetele ajung acum în webhook-ul tău - de fiecare dată când o etichetă este adăugată sau eliminată dintr-o conversație primești un mesaj label/add sau label/remove, ca să îți poți oglindi etichetele WhatsApp în propriul CRM în timp real

Control complet asupra profilului - citește și actualizează numele afișat, textul de descriere și numele de utilizator WhatsApp al numărului conectat cu noile endpoint-uri getProfileName / setProfileName, getProfileAbout / setProfileAbout și getProfileUsername / setProfileUsername (getProfileAbout/{conversation_id} citește și descrierea altui contact)

Vezi pe cine ai blocat - noul endpoint /{phone_id}/getBlockContacts returnează contactele blocate ale numărului

Află-ți cota de conversații noi înainte să o atingi - /{phone_id}/getNewChatLimit arată dacă WhatsApp limitează primele mesaje către contacte noi pentru număr, cât din cotă a fost folosit și când se resetează ciclul. Această limită este în prezent în testare la WhatsApp și deocamdată apare doar la conturile WhatsApp noi

Gestionează profilul de afaceri prin API - getBusinessProfile, getBusinessProfile/{conversation_id} și setBusinessProfile îți permit să citești profilul public propriu sau al altei afaceri și să actualizezi descrierea, adresa, emailul, site-urile și programul de lucru

Decide cine îți vede poveștile - getStoryPrivacy și setStoryPrivacy gestionează audiența poveștilor (toate contactele, o listă permisă sau o listă exclusă) numărului

Descoperă și alătură-te subgrupurilor unei comunități - community/unjoinedSubGroups/{conversation_id} listează subgrupurile în care nu ai intrat încă, iar community/joinSubGroup te alătură unuia dintre ele

Povești mai bogate - createStory acceptă acum povești audio (deocamdată doar fișiere OGG/Opus .oga), un backgroundColor personalizat pentru poveștile text și o audiență per poveste cu contacts / excludeContacts

Grupurile își cunosc comunitatea - getGroups returnează acum communityId și isCommunityAnnounce ca să știi ce grupuri aparțin unei comunități și care este grupul de anunțuri

Filtrează contactele după tip - noul parametru type (group sau contact) din /getContacts returnează doar intrările de care ai nevoie

Alege între viteză și prospețime - /getConversations/{conversation_id} acceptă fromCache și fresh ca să servești instant datele din cache sau să forțezi o citire live

Mai multe puncte de ieșire în lume - regiuni proxy noi: Rusia, Mexic, Hong Kong, Singapore, Vietnam, Ucraina, Statele Unite, Italia, Malaezia, Liban și Madagascar

Fix

S-a remediat createGroup

S-a remediat deconectarea automată (logout) a instanțelor

S-a aplicat o remediere avansată pentru starea conn-retry - instanțele au acum conexiuni socket WhatsApp mult mai stabile

S-a adăugat un mecanism de rezervă pentru returnarea conținutului media ca link - acum se returnează un link ori de câte ori instanța este conectată (era deja foarte fiabil)

S-au remediat getGroups și getCommunities

S-au remediat acțiunile profileImage

S-a remediat call/start

S-au remediat endpoint-urile acceptGroupInvite și createCallLink

S-a remediat scrierea fișierelor media primite cu extensia greșită (.jpeg, .mp4) când caption-ul conținea emoji

S-a remediat problema cipherText care bloca instanțele

S-a remediat endpoint-ul deactiveCommunity

15.09.2026

Nou

A fost adăugat parametrul days la /getConversations pentru a returna doar conversațiile din ultimele N zile

A fost adăugat parametrul refresh la /getGroups și /getGroups/{conversation_id} pentru a prelua din nou informațiile grupului de la WhatsApp; datele din cache pot returna în continuare numere @lid chiar și după ce au fost convertite în @c.us, prin urmare utilizarea refresh rămâne la latitudinea dumneavoastră

A fost mărită limita de dimensiune pentru trimiterea media în sendMessage la 50MB

A fost mărită limita conținutului media primit (la preluarea mesajelor) de la 40MB la 180MB

A fost mărită dimensiunea previzualizării linkurilor pentru mesajele channel_link în sendMessage (cu revenire automată la o previzualizare mai mică atunci când cea mai mare nu poate fi trimisă)

A fost adăugat suportul audio mp3 în sendMessage - fișierele mp3 sunt acum trimise corect

Au fost adăugate noi regiuni proxy: South America (Ecuador exit), Colombia, South Africa, Argentina, North Africa (Egypt exit), Southeast Asia (Indonesia exit), Israel, Cameroon, United Kingdom, Brazil, Spain, Chile și India

A fost adăugat un câmp isVideo la notificările de apeluri primite (mesaje info cu subtype call/ringing, call/miss, call/reject sau call/accept) care indică dacă apelul este un apel video

Fix

A fost remediată eroarea 'Contact could not found' în sendMessage - eroarea nu mai apare la trimiterea mesajelor

A fost remediat răspunsul 'CreateGroup could not complete.' în createGroup

A fost remediată o eroare la mesajele channel_text în sendMessage

A fost remediată o eroare la mesajele forward în sendMessage

A fost îmbunătățită validarea numerelor de telefon în checkPhones

A fost remediat call listener-ul pentru apelurile în curs (call/ringing)

14.08.2026

Nou

A fost adăugat un IP static opțional pentru webhook-uri - acum puteți activa un IP static pe pagina https://console.maytapi.com/developers/webhook, astfel încât livrările webhook să ajungă printr-un singur canal (IP)

A fost adăugat tipul de mesaj channel_question - acum puteți trimite întrebări la care se poate răspunde către canalele WhatsApp; întrebarea și răspunsurile sale (cu numele respondentului și id/phone când numărul este salvat) sunt returnate în getMessage și channel/getMessages

Fix

A fost remediată situația în care, la trimiterea mesajelor channel_media, conținutul media uneori nu apărea

A fost remediată situația în care editările message_edit uneori nu ajungeau prin webhook

A fost remediată o eroare în endpoint-urile getGroups și getCommunities

A fost remediată problema în care produsele nu erau adăugate în endpoint-ul /catalog/addProduct

A fost aplicată o remediere pentru cazul în care getCommunities returna uneori participanți în format lid - unii participanți pot fi în continuare returnați ca lid

A fost remediată problema în care mesajele cu butoane (buttons) nu erau trimise

08.07.2026

Nou

A fost adăugat endpoint-ul /{phone_id}/disappearingConversations/{conversation_id} pentru a seta cronometrul mesajelor care dispar (efemere) în conversațiile individuale (dezactivat, 24 de ore, 7 zile sau 90 de zile)

Fix

Detectarea evenimentului de deconectare (logout) a fost făcută fiabilă - ratările nedetectate au fost reduse la niveluri foarte scăzute

A fost remediată problema privind nelivrarea notificărilor de confirmare (ack)

A fost remediată detectarea codului QR

A fost remediată problema de creare a grupului în endpoint-ul createGroup

A fost remediată problema în care evenimentele de apel/sonerie (call/ringing) nu ajungeau la webhook-uri

A fost remediată gestionarea vCard în endpoint-ul sendMessage

A fost remediată problema la editarea configurației grupurilor vechi

A fost remediată problema din community/add în care invitațiile nu erau trimise persoanelor invitate

21.04.2026

Nou

S-a adaugat tipul de mesaj carousel in endpoint-ul SendMessage pentru trimiterea de mesaje carusel

pinMessage este acum livrat prin webhook ca reaction, pollVoteUpdate, message_edit si event_response - mesajul fixat este identificat prin campul parentMsgId

Fix

La trimiterea unei reactii prin endpoint-ul SendMessage, daca mesajul tinta nu poate fi gasit, webhook-ul returneaza acum mesajul de eroare 'Message could not found..!'

S-a imbunatatit si corectat functia de incarcare a mesajelor in endpoint-urile reply_to, /getMessage/{msgId}, /getMessages/{conversation_id} si alte endpoint-uri conexe

S-a corectat problema de recuperare a continutului media in mesajele media primite (aparea in mesajele mp4 limitate)

Valorile duration in pinMessage prin SendMessage sunt acum convertite in integer - formatul string vechi este inca suportat

13.03.2026

Nou

S-a adaugat suport pentru link media in mesajele cu butoane - acum puteti include un camp media cu un URL in cererile de mesaje cu butoane

Fix

S-au corectat problemele de trimitere a mesajelor sticker si product in endpoint-ul SendMessage

S-a corectat functionalitatea endpoint-ului /connectWithPhoneNumber

S-a corectat problema models la trimiterea mesajelor media

20.02.2026

Nou

S-a adaugat receptia mesajelor de tip order si livrarea prin webhook pentru urmarirea comenzilor WhatsApp

S-au adaugat endpoint-urile /{phone_id}/catalog/getOrders si /{phone_id}/catalog/getOrders/{orderId} pentru obtinerea informatiilor despre comenzi

S-a adaugat functionalitatea de trimitere a catalogului in endpoint-ul SendMessage pentru partajarea cataloagelor de produse in conversatii

Fix

S-a rezolvat problema descoperirii canalelor - toate canalele sunt acum returnate complet in raspunsuri

S-a rezolvat detectia evenimentului de deconectare - deconectarea este acum detectata fiabil in toate scenariile

S-a rezolvat eroarea 500 in endpoint-ul /{phone_id}/getGroups/{conversation_id}

S-a rezolvat eroarea de trimitere media in endpoint-ul SendMessage

S-a rezolvat functionalitatea endpoint-ului BlockContact

S-a rezolvat eroarea de validare a permisiunilor comunitatii

16.01.2026

Nou

Adăugată funcționalitatea de trimitere media către canal (Gif) pentru partajarea conținutului GIF în canale

Fix

Corectată funcționalitatea endpoint-urilor /contacts/add, /contacts/remove și /contacts/edit pentru gestionarea corectă a contactelor

Corectată problema de vizibilitate a voturilor în tipul de mesaj sondaj - voturile sunt acum afișate corect

Îmbunătățită încărcarea mesajelor anterioare pentru funcționalitatea reply_to

Corectată problema de timestamp în tipul de webhook message_edit

15.12.2025

Nou

S-au corectat returnarile ID-ului de utilizator @lid in endpoint-urile /contacts si /getConversations - acum returneaza formatul corect c.us sau g.us

S-a adaugat campul description la endpoint-urile /getGroups pentru obtinerea descrierilor grupurilor

Fix

S-a corectat functionalitatea endpoint-ului /group/add pentru gestionarea corespunzatoare a membrilor grupului

S-au corectat returnarile ID-ului de utilizator @lid in payload-urile de conversatie webhook - acum returneaza formatul c.us sau g.us in loc de lid

S-au corectat returnarile ID-ului de utilizator @lid in payload-urile ack (confirmare) - acum returneaza formatul c.us sau g.us

S-a corectat functionalitatea tipului de mesaj product in endpoint-ul SendMessage

12.11.2025

Nou

Au fost adăugate regiuni proxy din Africa de Nord, Asia de Sud-Est și Argentina pentru a îmbunătăți opțiunile de conectivitate globală

Au fost adăugate endpoint-urile /{phone_id}/contact/add, /{phone_id}/contact/edit și /{phone_id}/contact/remove la Operațiuni de Contact pentru gestionarea contactelor în mod programatic

Fix

A fost corectată funcționalitatea tipului forwardMessage în endpoint-ul SendMessage

A fost corectată funcționalitatea endpoint-ului /{phone_id}/group/approvalRequestList/{conversation_id} pentru gestionarea corectă a cererilor de aprobare de grup

A fost corectată funcționalitatea endpoint-ului /{phone_id}/connectWithPhoneNumber pentru a asigura conexiuni stabile ale numerelor de telefon

A fost corectată problema de deconectare automată care apărea imediat după scanarea codului QR pentru o gestionare mai bună a sesiunilor

14.10.2025

Nou

Adăugat parametrul deleteForEveryone la tipul de mesaj delete în endpoint-ul SendMessage - setați pe true pentru a șterge mesajele pentru toți participanții, sau false pentru a șterge doar pentru dvs.

Adăugat câmpul isBusiness la răspunsul endpoint-ului /{phone_id}/getContacts pentru identificarea conturilor de business

Adăugat tipul de notificare group/revoke_invite la webhook-urile info-message pentru urmărirea modificărilor link-urilor de invitație la grupuri și recuperarea link-urilor actualizate

Introdus tipul de webhook message-edit care returnează atât conținutul mesajului original, cât și cel modificat atunci când mesajele sunt editate

Adăugat endpoint-ul /{phone_id}/group/deleteProfileImage pentru ștergerea imaginilor de profil ale grupurilor

Adăugat endpoint-ul /{phone_id}/clearConversations/{conversation_id} pentru ștergerea istoricului de chat al conversațiilor specifice

Fix

Remediate problemele cu funcționalitatea endpoint-ului /{phone_id}/createGroup

Remediat gestionarea erorilor endpoint-ului /{phone_id}/group/acceptInvite

Remediat comportamentul parametrului de interogare invite în endpoint-urile /{phone_id}/getGroups și /{phone_id}/getGroups/{conversation_id} - invite=true returnează acum corect link-urile de invitație atunci când sunt disponibile

Remediat maparea ID-urilor de utilizator @lid în payload-urile mesajelor webhook pentru afișarea identificatorilor de utilizator corecți

Remediat eroarea care apărea la trimiterea link-urilor prin tipul de mesaj channel_text

Îmbunătățit urmărirea stării de deconectare în toate scenariile - evenimentele de deconectare sunt acum raportate în mod fiabil în webhook-urile de schimbare a stării

11.07.2025

Nou

Adăugat tipul de mesaj Invitație Canal la endpoint-ul SendMessage pentru trimiterea invitațiilor de canal

Adăugat tipul de mesaj Invitație Administrator Canal la endpoint-ul SendMessage pentru trimiterea invitațiilor de administrator la canale

Adăugat endpoint-ul /{phone_id}/channel/demote pentru retrogradarea administratorilor de canal

Adăugat endpoint-ul /{phone_id}/channel/acceptAdminInvite pentru acceptarea invitațiilor de administrator la canale

Adăugat endpoint-ul /{phone_id}/channel/revokeAdminInvite pentru revocarea invitațiilor de administrator de la canale

Adăugat tipul de webhook channel-invite-message pentru capturarea mesajelor de invitație canal

Adăugat tipul de webhook channel-admin-invite-message pentru capturarea mesajelor de invitație administrator canal

Fix

Corectat problema cu schimbarea numelui grupului unde numele grupurilor nu erau actualizate corect

08.07.2025

Nou

Au fost adăugate tipurile de mesaje de reacție și eliminare reacție la endpoint-ul SendMessage

A fost adăugată funcționalitatea de mesaj cu stea cu parametru de acțiune pentru marcarea/demarcarea mesajelor

A fost adăugat tipul de mesaj createEvent pentru crearea evenimentelor WhatsApp cu mesaj, descriere, startTime, endTime și locație

A fost adăugat tipul de mesaj event_response în payload-urile webhook pentru urmărirea răspunsurilor la evenimente

A fost adăugat tipul channel_audio la endpoint-ul SendMessage pentru conținut audio în canale

Fix

Au fost corectate ID-urile utilizator @lid în suportul pentru mențiuni în payload-urile mesajelor webhook

Au fost corectate ID-urile utilizator @lid în câmpul participanți al mesajelor de informație pentru a afișa numerele de telefon reale

05.05.2025

Nou

Adăugat parametrul isHd la endpoint-ul sendMedia pentru a permite trimiterea imaginilor HD când este suportat de WhatsApp (Nu convertim imaginile în HD, le trimitem doar în HD dacă WhatsApp suportă)

Îmbunătățit endpoint-ul createGroup cu opțiuni pentru setarea imaginii și configurației în timpul creării grupului

Adăugată funcționalitatea de returnare a imaginii la endpoint-ul getGroups

Fix

Rezolvate ID-urile utilizatorilor @lid în grupuri și mesaje livrate prin webhook

Rezolvate problemele de culoare în endpoint-urile createLabel și edit din secțiunea Labels

Rezolvată problema de afișare QR în endpoint-ul /screen unde o porțiune a codului QR nu era vizibilă

22.04.2025

Nou

A fost introdusă funcționalitatea webhook locationLive pentru a livra actualizări de locație în direct partajate printr-un nou tip de webhook

A fost îmbunătățit endpoint-ul sendMessage cu suport shortVideo pentru opțiuni mai versatile de partajare a conținutului media

Au fost extinse tipurile de răspuns webhook pentru a include formatul ptv (notă video), crescând varietatea formatelor video care pot fi capturate

A fost adăugat endpoint-ul /createLabel pentru crearea de etichete personalizate în WhatsApp Business cu nume și culori personalizabile

A fost implementat endpoint-ul /label/edit pentru modificarea proprietăților etichetelor existente, inclusiv a atributelor de nume și culoare

A fost adăugat endpoint-ul /label/remove pentru ștergerea simultană a uneia sau mai multor etichete din sistem

A fost introdus endpoint-ul /label/getlabelColors pentru a recupera toate opțiunile de culori disponibile pentru etichetele WhatsApp Business

Fix

Au fost rezolvate problemele de randare și procesare a stickerelor animate pentru îmbunătățirea funcționalității stickerelor pe toate platformele

09.04.2025

Nou

Changed webhook delivery format for reaction and pollVoteUpdate notifications - starting from 30.04.2025, these will only be delivered as sub-types under message type instead of under the ack structure

Fix

Fixed issue with /group/acceptInvite endpoint, now properly handling ALREADY_JOINED_THE_GROUP, INVALID_INVITE_CODE and REMOVED_FROM_GROUP error scenarios for better group invitation management

Fixed issue with /group/acceptInviteV4 endpoint, now correctly returning ALREADY_JOINED_THE_GROUP and INVALID_INVITE_CODE error responses for improved error handling

17.03.2025

Nou

Au fost introduse Operațiuni de Chat Comunitar pentru gestionarea comunităților

Au fost adăugate noi Operațiuni de Apel pentru îmbunătățirea funcționalității de gestionare a apelurilor

A fost adăugat statusul call/ringing la mesajul de informații pentru o mai bună urmărire a statusului apelurilor

Fix

A fost rezolvată problema cu endpoint-ul /{phone_id}/group/revokeInvite, utilizatorii pot acum să schimbe cu succes linkurile de invitație ale grupurilor lor

24.02.2025

Nou

Adăugat tipul list la endpoint-ul SendMessage pentru trimiterea mesajelor structurate în listă

Adăugate tipurile story_text și story_media la endpoint-ul SendMessage pentru a răspunde la poveștile contactelor

Introduse endpoint-urile /{phone_id}/contactsStories sau /{phone_id}/contactsStories/{conversation_id} pentru a lista poveștile contactelor cu ID-urile lor de conversație, care pot fi utilizate cu tipurile story_text și story_media pentru răspunsuri la povești

Fix

Optimizată performanța endpoint-urilor /{phone_id}/contactsStories și /{phone_id}/getStories pentru îmbunătățirea timpilor de răspuns

Îmbunătățită performanța scanării pentru tipurile de mesaje group_invite anterior omise

22.01.2025

Nou

Payload-uri webhook îmbunătățite cu suport pentru răspunsuri de acceptare a apelurilor, permițând o mai bună urmărire a apelurilor acceptate în conversațiile dvs

S-a implementat funcționalitatea de răspuns pentru respingerea apelurilor în payload-urile webhook, permițând monitorizarea apelurilor respinse prin API-ul WhatsApp

S-au extins tipurile de payload pentru mesajele webhook pentru a include group_invite și group_invite_v4, oferind detalii complete despre invitațiile de grup în răspunsurile webhook

Fix

S-a remediat și îmbunătățit gestionarea răspunsurilor pentru apeluri pierdute în payload-urile webhook pentru a oferi o urmărire mai fiabilă a stării apelurilor

09.01.2025

Nou

S-a adăugat suport pentru mesaje GIF în endpoint-ul SendMessage, permițând trimiterea de GIF-uri animate în conversațiile dvs. prin API-ul WhatsApp

Fix

S-au remediat răspunsurile pentru imagini în endpoint-ul getGroups/{conversation_id}

S-a adăugat suport complet pentru tipul sticker în endpoint-ul SendMessage

17.12.2024

Nou

Instrumentul JSON Escape/Unescape este acum disponibil pentru procesarea eficientă a datelor JSON. Instrumentul ajută dezvoltatorii să formateze corect șirurile JSON, să gestioneze caracterele speciale și să valideze datele JSON cu opțiuni de previzualizare instantanee și salvare a fișierelor. (Instrument nou)

Fix

S-a remediat suportul pentru mențiuni în payload-urile webhook

S-au remediat problemele de recuperare a fișierelor media la obținerea conținutului din canale (se recomandă furnizarea unei valori count pentru media recuperată)

S-au remediat problemele de actualizare a imaginii de profil a grupului în endpoint-ul /group/setProfileImage - imaginile grupului pot fi acum modificate cu succes

21.12.2023

Nou

Canalele WhatsApp sunt acum disponibile în WhatsApp API-ul nostru, poți vizita documentația pentru a le vedea.

Poți obține informații detaliate despre poveștile tale WhatsApp și poți, de asemenea, să împărtășești media (imagini, videoclipuri) în poveștile tale oricând dorești.

Poți primi reacții la mesajele tale în conversațiile WhatsApp prin WhatsApp API.

Poți urmări voturile date sondajelor partajate pe WhatsApp în timp real prin WhatsApp API.

Poveștile utilizatorilor din lista ta de contacte sunt acum accesibile prin WhatsApp API. Poți consulta secțiunea /contactsStories în documentație la Operațiuni de Povești (Beta) pentru mai multe detalii.

Acum poți trimite autocolante prin secțiunea de mesaje de autocolante în partea de 'SendMessage'.

Acum poți afișa indicatorul de tastare pentru mesajele tale text către cealaltă parte.

Am configurat procesul de trimitere a linkurilor către canale.

Poți obține informații detaliate despre mesajele tale prin intermediul endpoint-urilor cu 'Informații despre Mesaje'.

Acum, poți deveni partener cu API-ul nostru și să gestionezi propriile telefoane fără plăți inițiale. Pentru informații detaliate, poți vizita pagina Partener WhatsApp API