Μήνυμα WhatsApp API που δεν παραδόθηκε: οι αιτίες, με σειρά
Ένα μήνυμα WhatsApp API που έγινε αποδεκτό δεν είναι ένα μήνυμα που παραδόθηκε: η Meta αναφέρει το αποτέλεσμα αργότερα, σε ένα webhook κατάστασης, ως sent, delivered, read ή failed, με κωδικό σφάλματος. Ελέγξτε με τη σειρά: την κατάσταση failed και τον κωδικό της, το παράθυρο 24 ωρών (131047), τον τρόπο πληρωμής (131042), το template (132001, 132015), τον παραλήπτη (131026, 131049, 131050), και έπειτα τα όρια του αριθμού και τη σύνδεση.
Το easyCoexistence παρακολουθεί κάθε συνδεδεμένο αριθμό όλο το εικοσιτετράωρο, σας στέλνει email όταν η Meta σταματά να παραδίδει, αποσυνδέει τη σύνδεση ή μειώνεται η ποιότητα, και προωθεί τα webhooks κατάστασης της Meta αμετάβλητα στο σύστημά σας.
sent (ένα σημάδι ελέγχου), delivered (δύο), read (δύο μπλε) και failed (ένα κόκκινο τρίγωνο σφάλματος), όπως τα αναφέρουν τα webhooks κατάστασης.
Έχουν περάσει περισσότερες από 24 ώρες από την τελευταία απάντηση του παραλήπτη· η Meta λέει να στείλετε ένα template αντί γι' αυτό.
Αδυναμία παράδοσης: ο αριθμός δεν βρίσκεται στο WhatsApp, ο παραλήπτης δεν έχει αποδεχθεί τους νέους όρους ή χρησιμοποιεί παλιά έκδοση του WhatsApp.
Προεπιλεγμένος χρόνος κατά τον οποίο το WhatsApp επαναλαμβάνει την παράδοση ενός utility ή marketing template που δεν παραδόθηκε, πριν το απορρίψει· τα authentication templates έχουν προεπιλογή 10 λεπτά.
Σταθερό throughput ενός αριθμού που χρησιμοποιείται τόσο στην εφαρμογή WhatsApp Business όσο και στο Cloud API.
Γιατί ένα αποδεκτό μήνυμα εξακολουθεί να μην φτάνει;
Επειδή η απάντηση του API και η παράδοση είναι δύο διαφορετικά γεγονότα. Όταν στέλνετε, η Meta επιστρέφει ένα αναγνωριστικό (id) μόλις αποδεχθεί το αίτημα· το αν το μήνυμα φτάνει στο τηλέφωνο του πελάτη έρχεται αργότερα, σε ένα webhook κατάστασης στο πεδίο messages. Το sent σημαίνει ότι έφυγε από τους διακομιστές της Meta (ένα σημάδι ελέγχου), το delivered ότι έφτασε στη συσκευή (δύο), το read ότι διαβάστηκε (δύο μπλε), και το failed ότι δεν μπόρεσε να σταλεί ή να παραδοθεί, και σας εμφανίζεται με έναν πίνακα errors: code, title και error_data.details. Άρα η πρώτη κίνηση δεν είναι η εικασία: βρείτε την κατάσταση failed για αυτό το id και διαβάστε τον κωδικό της. Αν δεν έχετε προορισμό webhook, τίποτα δεν την καταγράφει.
Ποιες είναι οι αιτίες, με τη σειρά ελέγχου;
Από την πιο συχνή σε έναν νέο συνδεδεμένο αριθμό έως την πιο σπάνια. Κάθε γραμμή αναφέρει τον κωδικό της Meta, ώστε η κατάσταση failed να σας δείχνει σε ποια βρίσκεστε:
- Κλειστό παράθυρο: 131047, περισσότερες από 24 ώρες από τότε που έγραψε ο πελάτης για τελευταία φορά. Τα μηνύματα ελεύθερου κειμένου χρειάζονται ανοιχτό παράθυρο· στείλτε template.
- Πληρωμή: 131042, ή τα templates απορρίπτονται σιωπηλά. Από 1 Οκτωβρίου 2026 σταματούν και τα service messages μόλις χρησιμοποιηθούν 1.000 τον μήνα χωρίς τρόπο πληρωμής.
- Template: 132001 δεν έχει εγκριθεί ή έχει λάθος γλώσσα, 132000 λάθος αριθμός μεταβλητών, 132012 λάθος μορφή, 132015 σε παύση, 132016 απενεργοποιημένο.
- Παραλήπτης: 131026 δεν βρίσκεται στο WhatsApp, έχει παλιά έκδοση ή δεν έχει αποδεχθεί τους όρους· 131050 σταμάτησε τα marketing μηνύματα· 131049 κρατείται για υγιή αλληλεπίδραση· τα marketing templates προς αριθμούς ΗΠΑ δεν παραδίδονται.
- Όρια: 131048 περιορισμένο μετά από σήματα spam, 131056 πάρα πολλά μηνύματα σε ένα άτομο, 130429 throughput, 20 μηνύματα ανά δευτερόλεπτο σε αριθμό Coexistence.
- Λογαριασμός: 131031 ή 368, ο WhatsApp Business Account είναι περιορισμένος ή απενεργοποιημένος για παραβίαση πολιτικής.
- Σύνδεση: ο αριθμός δεν είναι πλέον συνδεδεμένος, για παράδειγμα μετά από 14 ημέρες χωρίς άνοιγμα της εφαρμογής WhatsApp Business.
Πώς χειρίζεστε τους κωδικούς της πλευράς του παραλήπτη;
Διαφορετικά, γιατί κάποιοι αξίζουν επανάληψη και κάποιοι ποτέ. Το 131050 σημαίνει ότι το άτομο επέλεξε να σταματήσει τα marketing μηνύματα από εσάς: η Meta λέει να μην επαναλάβετε, και το webhook user_preferences σας ενημερώνει όταν σταματά ή ξαναρχίζει. Το 131049 είναι η Meta που κρατά πίσω ένα marketing μήνυμα για να διατηρήσει υγιή αλληλεπίδραση, συχνά ένα ανά χρήστη όριο για marketing templates: η Meta συνιστά να περιμένετε τουλάχιστον 24 ώρες πριν από νέα αποστολή, γιατί αν στείλετε νωρίτερα θα πάρετε ξανά το ίδιο σφάλμα. Το 131026 καλύπτει αριθμούς που δεν βρίσκονται στο WhatsApp, χρήστες που δεν έχουν αποδεχθεί τους τρέχοντες όρους του WhatsApp και πολύ παλιές εκδόσεις της εφαρμογής· ελέγξτε πρώτα τη μορφή του αριθμού και τον κωδικό χώρας, και μετά ζητήστε από τον πελάτη να επικοινωνήσει μέσω άλλου καναλιού.
Για πόσο καιρό προσπαθεί το WhatsApp να παραδώσει το μήνυμα;
Για τον χρόνο ζωής (time to live) του μηνύματος. Όταν ένα τηλέφωνο είναι κλειστό ή εκτός κάλυψης, το WhatsApp επαναλαμβάνει την παράδοση αντί να αποτύχει αμέσως: από προεπιλογή για 30 ημέρες στα utility και marketing templates και για 10 λεπτά στα authentication templates. Μια επιχείρηση μπορεί να το μειώσει ανά template με το message_send_ttl_seconds, από 30 δευτερόλεπτα έως 12 ώρες για utility και από 30 δευτερόλεπτα έως 15 λεπτά για authentication. Ένα μήνυμα που δεν μπορεί να παραδοθεί εντός του TTL του απορρίπτεται. Άρα ένα μήνυμα με κατάσταση sent και χωρίς delivered μετά από ώρες συνήθως περιμένει στο τηλέφωνο του πελάτη, δεν έχει χαθεί· ορίστε σύντομο TTL για κωδικούς και ειδοποιήσεις με χρονική σημασία, ώστε μια καθυστερημένη παράδοση να μη μπερδεύει κανέναν.
Τι σημαίνει αυτό για τις απαντήσεις AI και τα automations;
Διαβάστε πρώτα την εκτέλεση, μετά την κατάσταση. Στην καρτέλα Runs, μια εκτέλεση Skipped δεν έστειλε τίποτα και λέει γιατί: «More than 24 hours since the customer's last message», «You answered this chat from your phone recently» ή «AI reply limit for this chat reached this hour». Μια εκτέλεση Done σημαίνει ότι η Meta αποδέχθηκε κάθε απάντηση, και αυτό δεν είναι απόδειξη παράδοσης. Το easyCoexistence δεν αποθηκεύει τις καταστάσεις μηνυμάτων: με ενεργά automations φτάνουν στο forward URL σας, αν έχετε ορίσει ένα, ενώ στη λειτουργία direct πηγαίνουν κατευθείαν στο δικό σας endpoint. Από το ChatGPT ή το Claude, ζητήστε από την AI σας να εκτελέσει το get_number_health: επιστρέφει την κατάσταση σε πραγματικό χρόνο, τη βαθμολογία ποιότητας και τα τελευταία 15 συμβάντα παρακολούθησης, συμπεριλαμβανομένου ενός μπλοκ sending με τον κωδικό της Meta.
Πώς να το ρυθμίσετε
- Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.
Συνηθισμένα λάθη
- Επανάληψη σε 131050. Το άτομο σταμάτησε τα marketing μηνύματα από εσάς· περισσότερες προσπάθειες δεν θα παραδοθούν ποτέ και μπορούν μόνο να προσθέσουν αρνητικά σήματα.
- Θεωρείτε ότι ένα αναγνωριστικό (id) σημαίνει παράδοση. Η Meta αποδέχεται πρώτα και αναφέρει τις αποτυχίες αργότερα, οπότε μια ροή εργασίας που σταματά στο id χάνει κάθε μήνυμα που απορρίφθηκε.
- Αποστολή ελεύθερης απάντησης μία ημέρα αργότερα. Μετά από 24 ώρες χωρίς μήνυμα του πελάτη γίνεται δεκτό μόνο template.
- Λειτουργία χωρίς προορισμό webhook. Οι αποτυχημένες καταστάσεις φτάνουν μόνο ως webhooks, οπότε χωρίς αυτόν χάνεται ο λόγος που ένα μήνυμα δεν έφτασε.
Η AI σας μπορεί να ελέγξει έναν αριθμό από το ChatGPT ή το Claude με το get_number_health. Από US$ 9 έως US$ 0,75 ανά αριθμό τον μήνα, με μείωση όσο προσθέτετε αριθμούς, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Γιατί το μήνυμα έδειχνε ένα σημάδι ελέγχου για ώρες;
Το ένα σημάδι ελέγχου είναι η κατάσταση sent: η Meta το έστειλε, αλλά το τηλέφωνο δεν το έχει λάβει, συνήθως επειδή είναι κλειστό ή offline. Το WhatsApp συνεχίζει τις προσπάθειες μέχρι να λήξει ο χρόνος ζωής του template, 30 ημέρες από προεπιλογή για utility και marketing.
Γιατί φτάνουν οι απαντήσεις, αλλά τα templates όχι;
Συνήθως πρόκειται για πρόβλημα τρόπου πληρωμής στον WhatsApp Business Account. Η Meta παραδίδει service messages εντός του μηνιαίου δωρεάν ορίου του αριθμού χωρίς αυτόν, αλλά δεν παραδίδει templates. Προσθέστε κάρτα στην ενότητα «Billing & payments».
Μπορώ να δω τα αποτυχημένα μηνύματα στην εφαρμογή WhatsApp Business;
Όχι με αξιοπιστία. Σε αριθμό Coexistence, τα μηνύματα που στέλνονται μέσω του API εμφανίζονται στη συνομιλία της εφαρμογής, αλλά ο λόγος της αποτυχίας έρχεται μόνο στον κωδικό σφάλματος του webhook κατάστασης.
Χρεώνει η Meta για μηνύματα που δεν παραδόθηκαν;
Όχι. Η Meta χρεώνει μόνο τα παραδομένα μηνύματα, και οι προσπάθειες με template σε παύση δεν χρεώνονται επίσης.
Συνεχίστε την ανάγνωση
Έτοιμοι να ξεκινήσετε;
Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.
Ξεκινήστε δωρεάν δοκιμήΕπαληθεύτηκε στις