ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
Meta Tech Provider

Γιατί ένα μήνυμα WhatsApp απέτυχε: ανάγνωση της κατάστασης failed και των σφαλμάτων

Το webhook αποτυχίας σημαίνει ότι η Meta δεν μπόρεσε να στείλει ή να παραδώσει ένα μήνυμα που έστειλε η επιχείρηση μέσω του API. Φτάνει στο πεδίο messages με τιμή failed στο πεδίο status και έναν πίνακα errors που περιέχει code, title, message, error_data.details και href. Ο κωδικός δείχνει την αιτία: 131047 κλειστό παράθυρο 24 ωρών, 131026 μη παραδοτέο, 131049 όριο μάρκετινγκ, 131050 διακοπή μάρκετινγκ, 131042 πρόβλημα πληρωμής.

Το easyCoexistence συνδέει τον αριθμό σας της εφαρμογής WhatsApp Business με το Cloud API της Meta μέσω Coexistence και περνά τις καταστάσεις failed στον server σας, απευθείας ή ως υπογεγραμμένα forwards όταν οι αυτοματισμοί είναι ενεργοί.

131047

Έχουν περάσει περισσότερες από 24 ώρες από την τελευταία απάντηση του παραλήπτη· η λύση της Meta είναι να στείλετε πρότυπο μηνύματος.

131049

Δεν παραδόθηκε, για να διατηρηθεί υγιής η δραστηριότητα του οικοσυστήματος· περιμένετε τουλάχιστον 24 ώρες πριν ξαναστείλετε το πρότυπο μάρκετινγκ.

131050

Ο παραλήπτης επέλεξε να σταματήσει τα μηνύματα μάρκετινγκ από την επιχείρηση· η Meta λέει να μην επαναληφθεί η αποστολή.

No contacts

Η κατάσταση failed δεν περιλαμβάνει τον πίνακα contacts· συσχετίστε την αποτυχία μέσω του statuses.id.

Delivered

Η Meta χρεώνει μηνύματα όταν παραδίδονται, όχι όταν στέλνονται.

Πώς μοιάζει μια κατάσταση failed;

Όπως κάθε κατάσταση, με επιπλέον errors. Ο πίνακας contacts λείπει, το recipient_user_id παραλείπεται όταν το μήνυμα στάλθηκε σε αριθμό τηλεφώνου, και δεν υπάρχει αντικείμενο pricing. Τα title και message περιέχουν το ίδιο κείμενο, το error_data.details το εξηγεί σε μία πρόταση, και το href δείχνει στη λίστα κωδικών σφαλμάτων της Meta. Αυτό είναι παράδειγμα της ίδιας της Meta: ένα πρότυπο μάρκετινγκ που σταμάτησε από το όριο ανά χρήστη:

Meta's example: a message that failed with 131049
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "statuses": [
              {
                "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0QUQ2MjA4NEYyRkExNjMyREUA",
                "status": "failed",
                "timestamp": "1751142888",
                "recipient_id": "16505551234",
                "errors": [
                  {
                    "code": 131049,
                    "title": "This message was not delivered to maintain healthy ecosystem engagement.",
                    "message": "This message was not delivered to maintain healthy ecosystem engagement.",
                    "error_data": {
                      "details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
                    },
                    "href": "/documentation/business-messaging/whatsapp/support/error-codes"
                  }
                ]
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Ποιοι κωδικοί σφάλματος επιστρέφουν πιο συχνά και τι σημαίνουν;

Η Meta επιστρέφει σφάλματα στην απάντηση αποστολής, σε μια κατάσταση failed, ή και στις δύο, οπότε ο ίδιος κωδικός μπορεί να φτάσει με οποιονδήποτε τρόπο και ο χειριστής σας πρέπει να διαβάζει και τα δύο σημεία. Αυτοί είναι οι κωδικοί που εξηγούν τα περισσότερα μηνύματα που δεν φτάνουν, με την αιτιολογία της Meta και το πρώτο πράγμα που πρέπει να δοκιμάσετε· η πλήρης λίστα βρίσκεται στην αναφορά κωδικών σφαλμάτων της Meta:

131026Undeliverable: not a WhatsApp number, terms not accepted, or an outdated WhatsApp version on the recipient's phone.
131047More than 24 hours since the customer last wrote. Send an approved template instead.
131049Held back to keep engagement healthy, usually the per-user marketing limit. Wait 24 hours or more.
131050The customer stopped marketing messages from you. Do not retry.
131042A problem with the payment method on the WhatsApp Business Account.
130472Not sent because the recipient is part of Meta's marketing message experiment.
131053Media could not be uploaded, often an unsupported file type.
131000Unknown error. Try again; if it persists, open a Direct Support ticket.

Πώς πρέπει να αντιδρά ο χειριστής σε κάθε είδος αποτυχίας;

Ταξινομήστε τον κωδικό ως προς το επόμενο βήμα πριν γίνει οποιαδήποτε επανάληψη. Μια γενική επανάληψη μετατρέπει μια διακοπή μάρκετινγκ σε επαναλαμβανόμενες αποτυχίες και μπορεί να παρατείνει τον αποκλεισμό, ενώ η απόρριψη ενός προσωρινού σφάλματος χάνει ένα μήνυμα που θα είχε περάσει ένα λεπτό αργότερα.

  • Επανάληψη με backoff: 131000 άγνωστο, 131016 μη διαθέσιμη υπηρεσία, 130429 επίτευξη μέγιστου ρυθμού αποστολής.
  • Πρώτα αναμονή: 131049, τουλάχιστον 24 ώρες, γιατί οι πρόωρες επαναλήψεις μπορούν να αποκλείσουν αυτόν τον χρήστη για έως 24 ώρες επιπλέον.
  • Αλλαγή μηνύματος: 131047 χρειάζεται εγκεκριμένο πρότυπο, επειδή το παράθυρο 24 ωρών είναι κλειστό.
  • Διακοπή για αυτόν τον πελάτη: 131050, έως ότου φτάσει ένα user_preferences resume.
  • Διόρθωση λογαριασμού ή περιεχομένου: 131042 πληρωμή, 131031 περιορισμένος λογαριασμός, 131053 πολυμέσα.

Ποιες αποτυχίες εμφανίζονται μόνο ως κατάσταση failed;

Εκείνες που αποφασίζει η Meta αφού έχει δεχτεί το αίτημα. Η αποστολή επιστρέφει ένα wamid, και η άρνηση έρχεται αργότερα σε αυτό το webhook. Η Meta δεν παραδίδει πρότυπα μάρκετινγκ σε χρήστες WhatsApp με αριθμούς των Ηνωμένων Πολιτειών (+1 με κωδικό περιοχής ΗΠΑ), ένα πρότυπο μάρκετινγκ προς πελάτη που σταμάτησε τα μηνύματα μάρκετινγκ υποβάλλεται σε επεξεργασία και στη συνέχεια αναφέρεται ως failed με 131050, και το όριο ανά χρήστη αναφέρει 131049 με τον ίδιο τρόπο.

Αν ο αριθμός δεν έχει προορισμό webhook, αυτές οι αποτυχίες δεν εμφανίζονται πουθενά που να μπορείτε να δείτε, και το μήνυμα απλώς φαίνεται σταλμένο. Για την πλήρη σειρά ελέγχων όταν ένας πελάτης δεν έλαβε τίποτα, δείτε τη σελίδα για τα μηνύματα WhatsApp API που δεν παραδόθηκαν.

Τι αλλάζει σε αριθμό Coexistence;

Δύο πράγματα έχουν σημασία. Πρώτον, το παράθυρο 24 ωρών δεσμεύει μόνο το API. Ο οδηγός Coexistence της Meta λέει ότι τα μηνύματα που στέλνονται από την εφαρμογή WhatsApp Business δεν υπόκεινται στο παράθυρο εξυπηρέτησης πελατών, οπότε μετά από 131047 ο ιδιοκτήτης μπορεί ακόμα να απαντήσει σε αυτόν τον πελάτη από το τηλέφωνο, ενώ το σύστημά σας στέλνει εγκεκριμένο πρότυπο.

Δεύτερον, ο ρυθμός αποστολής είναι σταθερός. Ένας αριθμός που χρησιμοποιείται ταυτόχρονα στην εφαρμογή και στο API στέλνει το πολύ 20 μηνύματα το δευτερόλεπτο, και αν ξεπεραστεί αυτό επιστρέφεται 130429. Όλα τα υπόλοιπα διαβάζονται ακριβώς όπως σε κάθε αριθμό Cloud API: το ίδιο πεδίο, ο ίδιος πίνακας errors, οι ίδιοι κωδικοί.

Πώς βλέπουν οι αυτοματισμοί και η AI σας μια αποτυχία;

Εξαρτάται από το πότε η Meta λέει όχι. Μια άρνηση τη στιγμή της αποστολής, όπως το 131047, αποτυγχάνει το βήμα του αυτοματισμού: η εκτέλεση εμφανίζει Failed με το μήνυμα της Meta στην καρτέλα Runs, και ο ιδιοκτήτης λαμβάνει email ώστε να απαντήσει ο ίδιος στον πελάτη. Οι αυτοματισμοί ελέγχουν επίσης το παράθυρο πριν στείλουν ελεύθερο κείμενο και παραλείπουν με window_closed αντί να προσπαθήσουν.

Μια αποτυχία που αναφέρει η Meta αργότερα φτάνει ως κατάσταση failed στο Forward URL σας ή στον άμεσο προορισμό, και η εκτέλεση μένει όπως ήταν. Ένα AI που έστειλε πρότυπο μέσω του συνδέσμου MCP βλέπει το wamid και το "sent: true"· ζητήστε από το σύστημά σας την κατάσταση αυτού του wamid, ή ζητήστε από τον βοηθό να εκτελέσει το get_number_health όταν αποτυγχάνουν πολλά μηνύματα ταυτόχρονα.

Συνηθισμένα λάθη

  • Επανάληψη του 131050 σε βρόχο. Ο πελάτης σταμάτησε τα μηνύματα μάρκετινγκ, οπότε κάθε προσπάθεια αποτυγχάνει με τον ίδιο τρόπο μέχρι να τα ξαναενεργοποιήσει.
  • Επαναποστολή προτύπου μάρκετινγκ με 131049 μέσα σε λίγες ώρες. Η Meta ζητά τουλάχιστον 24 ώρες, και οι πρόωρες επαναλήψεις μπορούν να αποκλείσουν αυτόν τον χρήστη για έως 24 ώρες επιπλέον.
  • Καταγραφή μόνο του title. Το error_data.details φέρει τη συγκεκριμένη αιτία, οπότε αποθηκεύστε τον κωδικό και τις λεπτομέρειες μαζί με το wamid.
  • Λειτουργία χωρίς προορισμό webhook και κρίση της παράδοσης από την απάντηση αποστολής, η οποία μόνο λέει ότι η Meta δέχτηκε το μήνυμα.
Κάντε το με EasyCoexistence

Όταν η απάντηση ενός αυτοματισμού απορρίπτεται τη στιγμή της αποστολής, η εκτέλεση εμφανίζει το σφάλμα της Meta και λαμβάνετε email, ενώ κάθε αριθμός παρακολουθείται 24/7 για αποσυνδέσεις και πτώσεις ποιότητας. Από US$ 9 μέχρι US$ 0,75 ανά αριθμό τον μήνα, με μείωση όσο προσθέτετε αριθμούς, και οι πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Χρεώνει η Meta ένα μήνυμα που απέτυχε;

Οι σελίδες τιμολόγησης της Meta λένε ότι χρεώνει μηνύματα που παραδίδονται, όχι μηνύματα που μόνο στάλθηκαν. Μια κατάσταση failed δεν περιέχει αντικείμενο pricing. Οι χρεώσεις πηγαίνουν στον δικό σας λογαριασμό WhatsApp Business, και το easyCoexistence δεν τις αυξάνει ποτέ.

Σημαίνει το 131026 ότι ο πελάτης απέκλεισε την επιχείρηση;

Η λίστα της Meta για το 131026 αναφέρει άλλες αιτίες: ο αριθμός δεν είναι στο WhatsApp, ο παραλήπτης δεν έχει αποδεχτεί τους τελευταίους όρους, ή η έκδοση WhatsApp του είναι πολύ παλιά. Η Meta προτείνει να ρωτήσετε τον πελάτη μέσω άλλου καναλιού για να τα ελέγξει.

Γιατί το recipient_user_id εμφανίζεται σε ορισμένες αποτυχίες και σε άλλες όχι;

Η Meta το παραλείπει σε μια κατάσταση failed όταν το μήνυμα στάλθηκε σε αριθμό τηλεφώνου. Όταν στείλατε στο BSUID του πελάτη, η αποτυχία το περιλαμβάνει, και μπορεί να λείπει το recipient_id.

Μπορεί ένα μήνυμα να αποτύχει αφού παραδόθηκε;

Η αναφορά της Meta περιγράφει το failed ως αποτυχία αποστολής ή παράδοσης. Αφού ένα μήνυμα φτάσει στη συσκευή, οι επόμενες καταστάσεις που μπορείτε να περιμένετε είναι read, ή played για φωνητικά μηνύματα.

Συνεχίστε την ανάγνωση

Καταστάσεις webhook του WhatsApp: εστάλη, παραδόθηκε, διαβάστηκε και απέτυχεΠώς το WhatsApp αναφέρει τι συνέβη σε μήνυμα που στείλατε: ο πίνακας statuses, κάθε τιμή, κάθε πεδίο και η αντιστοίχιση με το wamid της Meta.WhatsApp user_preferences webhook: όταν ένας πελάτης σταματά ή επαναφέρει τα διαφημιστικά μηνύματαΤο webhook user_preferences ενεργοποιείται όταν ένας πελάτης σταματά ή επαναφέρει τα διαφημιστικά μηνύματά σας. Εξηγούμε το payload και τη λύση 131050.Μήνυμα WhatsApp API που δεν παραδόθηκε: οι αιτίες, με σειράΜήνυμα WhatsApp API που δεν φτάνει: το webhook κατάστασης, το παράθυρο 24 ωρών, η πληρωμή, το template, ο παραλήπτης και τα όρια, με σειρά ελέγχου.Το template του WhatsApp σε παύση ή απενεργοποιημένο: τι να κάνετεΈνα template WhatsApp χαμηλής ποιότητας τίθεται σε παύση για 3 ώρες, μετά για 6 και τέλος απενεργοποιείται. Πώς το αναγνωρίζετε και τι να αλλάξετε.Σφάλμα 131049 του WhatsApp: αποκλεισμένο μήνυμα για την υγεία του οικοσυστήματοςΤο σφάλμα 131049 σημαίνει ότι η Meta απέκλεισε την αποστολή για την υγεία του οικοσυστήματος, όχι επειδή έκλεισε το παράθυρο 24 ωρών. Το template δεν βοηθά.Το 24ωρο παράθυρο εξυπηρέτησης πελατώνΤι είναι το παράθυρο εξυπηρέτησης, πότε ανοίγει και κλείνει, τι στέλνετε μέσα ή έξω από αυτό και γιατί οι απαντήσεις δεν χρεώνονται.

Έτοιμοι να ξεκινήσετε;

Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.

Ξεκινήστε δωρεάν δοκιμή

Επαληθεύτηκε στις