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

Τα webhooks κλήσεων του WhatsApp: γεγονότα του Calling API και κλήσεις σε αριθμό Coexistence

Το πεδίο calls του webhook αναφέρει γεγονότα του WhatsApp Business Calling API: σύνδεση με απάντηση ή προσφορά SDP, καταστάσεις κλήσης RINGING, ACCEPTED και REJECTED, τερματισμό με COMPLETED ή FAILED και τη διάρκεια, και call_recording_available ή call_transcription_available. Ο οδηγός Coexistence της Meta αναφέρει ότι οι φωνητικές και βιντεοκλήσεις παραμένουν αμετάβλητες στην εφαρμογή WhatsApp Business και δεν υποστηρίζονται στο Cloud API, άρα αυτές οι κλήσεις μένουν στο τηλέφωνο.

Το easyCoexistence συνδέει τον αριθμό σας στην εφαρμογή WhatsApp Business με το Cloud API της Meta μέσω του Coexistence, ώστε η AI και οι αυτοματισμοί σας να απαντούν σε μηνύματα και να στέλνουν πρότυπα, ενώ οι κλήσεις συνεχίζουν να χτυπούν στην εφαρμογή στο τηλέφωνό σας.

Not supported

Φωνητικές και βιντεοκλήσεις στο Cloud API για αριθμό που συνδέθηκε με την εφαρμογή WhatsApp Business, στην εφαρμογή παραμένουν αμετάβλητες.

2,000

Ελάχιστο ημερήσιο όριο μηνυμάτων, σε μοναδικούς παραλήπτες, που χρειάζεται ένας αριθμός για να χρησιμοποιήσει το Calling API.

7 days

Για πόσο διάστημα οι εγγραφές και οι μεταγραφές κλήσεων παραμένουν διαθέσιμες για λήψη μετά την παράδοση του webhook τους.

wacid

Το πρόθεμα των ids κλήσεων, η τιμή που συνδέει τα webhooks σύνδεσης, κατάστασης και τερματισμού μιας κλήσης.

whatsapp_business_messaging

Η άδεια που χρειάζεται μια εφαρμογή για να λαμβάνει webhooks κλήσεων, η ίδια με εκείνη για τα μηνύματα.

Τι αναφέρει το πεδίο calls του webhook;

Όλα όσα συμβαίνουν σε μια κλήση που πραγματοποιείται ή λαμβάνεται μέσω του Calling API, σε ένα πεδίο με ένα γεγονός για κάθε στάδιο. Μια κλήση που ξεκινά η επιχείρηση παράγει ένα γεγονός σύνδεσης, ενημερώσεις κατάστασης και ένα γεγονός τερματισμού. Οι κλήσεις μέσω SIP αναφέρουν call_created αντί για connect, χωρίς τη συνεδρία SDP. Ένα σχετικό γεγονός βρίσκεται αλλού: όταν ένας πελάτης απαντά σε αίτημα άδειας κλήσης, η απάντηση φτάνει στο πεδίο messages ως διαδραστικό μήνυμα τύπου call_permission_reply.

connectThe call is ready to connect; session carries the SDP to apply to your WebRTC stack.
call_createdA SIP call was attempted, business- or user-initiated.
statuses (type call)RINGING, ACCEPTED or REJECTED for a business-initiated call.
terminateThe call ended: status COMPLETED or FAILED, with times and duration when answered.
call_recording_availableA media id for the finished audio recording.
call_transcription_availableA media id for the transcript, a JSON document.

Πώς μοιάζει ένα webhook κλήσης;

Την ίδια δομή με κάθε webhook του WhatsApp, με έναν πίνακα calls κάτω από το value και field ίσο με calls. Το direction δηλώνει BUSINESS_INITIATED ή USER_INITIATED, τα from και to φέρουν τους αριθμούς τηλεφώνου, το to_user_id το BSUID του πελάτη, και οποιοσδήποτε αριθμός μπορεί να λείπει για πελάτη που χρησιμοποιεί όνομα χρήστη. Το metadata.phone_number_id προσδιορίζει τον αριθμό σας, όπως σε κάθε άλλο πεδίο. Αυτό είναι το παράδειγμα Call Connect της Meta, με τα placeholders όπως τα τυπώνει η Meta:

Meta's example: the Call Connect webhook
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "16315553601",
              "phone_number_id": "<PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<CALLEE_NAME>",
                  "username": "<USERNAME>"
                },
                "wa_id": "16315553602",
                "user_id": "<BSUID>",
                "parent_user_id": "<PARENT_BSUID>"
              }
            ],
            "calls": [
              {
                "id": "wacid.ABGGFjFVU2AfAgo6V-Hc5eCgK5Gh",
                "to": "16315553601",
                "to_user_id": "<BSUID>",
                "to_parent_user_id": "<PARENT_BSUID>",
                "from": "16315553602",
                "event": "connect",
                "timestamp": "1671644824",
                "direction": "BUSINESS_INITIATED",
                "session": {
                  "sdp_type": "answer",
                  "sdp": "<<RFC 8866 SDP>>"
                }
              }
            ]
          },
          "field": "calls"
        }
      ]
    }
  ]
}

Ποια πεδία προσθέτει το γεγονός terminate;

Το terminate είναι το γεγονός που αποθηκεύουν τα περισσότερα συστήματα, επειδή κλείνει την κλήση. Τα πεδία του, σύμφωνα με την αναφορά της Meta:

  • status: COMPLETED όταν η κλήση τελείωσε χωρίς απροσδόκητα σφάλματα, συμπεριλαμβανομένων των αναπάντητων κλήσεων. FAILED όταν δεν συνδέθηκε ή διακόπηκε.
  • start_time, end_time και duration σε δευτερόλεπτα: υπάρχουν μόνο όταν ο άλλος συμμετέχων σήκωσε το τηλέφωνο.
  • errors: code, message, href και error_data.details σε κλήση FAILED.
  • biz_opaque_callback_data: η δική σας συμβολοσειρά παρακολούθησης, όταν τη δώσατε κατά την εκκίνηση ή την αποδοχή της κλήσης.

Λειτουργούν τα webhooks κλήσεων σε αριθμό Coexistence;

Ο οδηγός Coexistence της Meta το απαντά στον πίνακα λειτουργιών του: οι φωνητικές και βιντεοκλήσεις δεν αλλάζουν στην εφαρμογή WhatsApp Business και δεν υποστηρίζονται στο Cloud API για αριθμό που συνδέθηκε με αυτόν τον τρόπο. Οι προαπαιτήσεις του ίδιου του Calling API λένε το ίδιο από την άλλη πλευρά: ο αριθμός της επιχείρησης πρέπει να χρησιμοποιείται με το Cloud API, όχι με την εφαρμογή WhatsApp Business. Άρα σε αριθμό Coexistence οι πελάτες συνεχίζουν να καλούν όπως πριν, η κλήση χτυπά στην εφαρμογή του τηλεφώνου, και το πεδίο calls δεν έχει τίποτα να αναφέρει. Μια επιχείρηση που χρειάζεται κλήσεις μέσα σε λογισμικό χρησιμοποιεί αριθμό μόνο στο Cloud API.

Πώς συνδέονται τα γεγονότα μιας κλήσης;

Με το id κλήσης, που ξεκινά με wacid και επαναλαμβάνεται σε κάθε γεγονός της κλήσης. Μια κλήση που ξεκινά η επιχείρηση αναφέρει σύνδεση με την απάντηση SDP, καταστάσεις RINGING και μετά ACCEPTED ή REJECTED, και τέλος terminate. Μια κλήση που ξεκινά ο χρήστης αναφέρει σύνδεση με προσφορά SDP για να την απαντήσει η δική σας στοίβα, και μετά terminate. Τα γεγονότα εγγραφής και μεταγραφής, όταν είναι ενεργοποιημένα, έρχονται μετά το terminate. Αποθηκεύστε τα γεγονότα με κλειδί το id και το event, επειδή οι επαναδοκιμές τα επαναλαμβάνουν και η σειρά άφιξης δεν είναι εγγυημένη. Η πλήρης λίστα των προαπαιτήσεων του Calling API βρίσκεται στη σελίδα για κλήσεις σε αριθμό Coexistence.

Τι μπορεί να κάνει η AI σας για κλήσεις σε αριθμό Coexistence;

Εργάζεται στη συνομιλία, ενώ οι κλήσεις μένουν στο άτομο που είναι στο τηλέφωνο. Το easyCoexistence δεν εγγράφεται στο πεδίο calls και δεν έχει εργαλεία κλήσεων. Ο connector του και οι αυτοματισμοί του καλύπτουν μηνύματα και πρότυπα. Στην πράξη, αυτό σημαίνει ότι μια απάντηση AI μπορεί να πει σε πελάτη πότε είναι διαθέσιμος κάποιος για να μιλήσει και ποιον αριθμό να καλέσει, ένας αυτοματισμός με λέξη-κλειδί μπορεί να απαντά στο «call» ή στο «phone» με αυτές τις πληροφορίες, και ο ιδιοκτήτης σηκώνει την κλήση στην εφαρμογή WhatsApp Business όπως και πριν.

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

  • Εγγραφή στο calls για αριθμό Coexistence και αναμονή γεγονότων. Η Meta αναφέρει τις κλήσεις ως μη υποστηριζόμενες στο Cloud API για αυτούς τους αριθμούς.
  • Αναμονή των start_time και duration σε κάθε terminate. Εμφανίζονται μόνο όταν απαντήθηκε η κλήση, ενώ μια αναπάντητη κλήση τελειώνει με COMPLETED.
  • Αναζήτηση απαντήσεων άδειας στο πεδίο calls. Φτάνουν στο messages, ως διαδραστικό call_permission_reply.
  • Αφήνετε τις εγγραφές και τις μεταγραφές στη Meta. Και τα δύο μπορούν να ληφθούν για 7 ημέρες μετά το webhook τους, και μετά χάνονται.
Κάντε το με EasyCoexistence

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

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

Χάνουν οι πελάτες το κουμπί κλήσης όταν ένας αριθμός συνδέεται με το API μέσω Coexistence;

Ο οδηγός Coexistence της Meta αναφέρει ότι οι φωνητικές και βιντεοκλήσεις παραμένουν αμετάβλητες στην εφαρμογή WhatsApp Business. Οι πελάτες καλούν τον ίδιο αριθμό, και ο ιδιοκτήτης απαντά στην εφαρμογή στο τηλέφωνο.

Χρεώνεται το Calling API όπως τα μηνύματα;

Όχι. Η σελίδα τιμολόγησης της Meta αναφέρει ότι το Calling API έχει διαφορετική τιμολόγηση και παραπέμπει σε ξεχωριστό έγγραφο τιμολόγησης κλήσεων, οπότε οι χρεώσεις κλήσεων δεν εμφανίζονται στο αντικείμενο pricing των καταστάσεων μηνυμάτων.

Μπορεί να εγγραφεί ή να μεταγραφεί μια κλήση του Calling API;

Ναι, όταν είναι ενεργοποιημένη η εγγραφή ή η μεταγραφή. Μετά την κλήση, η Meta στέλνει call_recording_available με media id ήχου ή call_transcription_available με id εγγράφου JSON, συνήθως μέσα σε ένα λεπτό.

Μπορεί ένα webhook κλήσεων να πηγαίνει σε διαφορετικό endpoint από αυτό της εφαρμογής;

Ναι. Το calls είναι ένα από τα πεδία που η Meta επιτρέπει σε έναν WhatsApp Business Account ή αριθμό τηλεφώνου να δρομολογεί σε εναλλακτικό callback URL, μαζί με τα messages και τα πεδία Coexistence.

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

Κλήσεις WhatsApp Business σε αριθμό CoexistenceΟι κλήσεις στην εφαρμογή WhatsApp Business συνεχίζουν να λειτουργούν μετά το Coexistence. Το Calling API της Meta όμως δεν υποστηρίζει τέτοιους αριθμούς.Καταστάσεις webhook του WhatsApp: εστάλη, παραδόθηκε, διαβάστηκε και απέτυχεΠώς το WhatsApp αναφέρει τι συνέβη σε μήνυμα που στείλατε: ο πίνακας statuses, κάθε τιμή, κάθε πεδίο και η αντιστοίχιση με το wamid της Meta.Ποιες λειτουργίες του WhatsApp παύουν μετά το CoexistenceΤα μηνύματα που εξαφανίζονται, η προβολή μία φορά, η ζωντανή τοποθεσία και οι λίστες broadcast απενεργοποιούνται σε συνδεδεμένο αριθμό. Τι σημαίνει το καθένα.Τι συγχρονίζεται με το API και τι όχιΟι επαφές και το ιστορικό 1:1 συγχρονίζονται. Ομάδες, κατάλογος, ετικέτες, γρήγορες απαντήσεις και μηνύματα απουσίας όχι. Όλα εδώ.Μετάβαση ενός αριθμού από το Coexistence μόνο στο Cloud APIΠώς βγαίνει ένας αριθμός από την εφαρμογή WhatsApp Business και λειτουργεί μόνο στο Cloud API: σειρά βημάτων, χαμένο ιστορικό, αλλαγές.Επαναλήψεις, διπλότυπα και σειρά των webhooks του WhatsApp: πώς να τα χειριστείτεΗ Meta επαναλαμβάνει τα webhooks του WhatsApp έως 7 ημέρες, άρα τα διπλότυπα είναι φυσιολογικά. Κλειδιά αποκλεισμού και ασφαλής χειριστής.

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

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

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

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