Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsApp-puhelujen webhookit: Calling API -tapahtumat ja puhelut Coexistence-numerossa

calls-kenttä raportoi WhatsApp Business Calling API -tapahtumat: connect-tapahtuman SDP-vastauksella tai -tarjouksella, puhelun tilat RINGING, ACCEPTED ja REJECTED, terminate-tapahtuman tilat COMPLETED tai FAILED sekä keston, ja call_recording_available tai call_transcription_available. Metan Coexistence-opas listaa ääni- ja videopuhelut muuttumattomiksi WhatsApp Business -sovelluksessa eikä niitä tueta Cloud API:ssa, joten nämä puhelut jäävät puhelimeen.

easyCoexistence yhdistää WhatsApp Business -sovelluksen numerosi Metan Cloud API:in Coexistencen kautta, joten tekoälysi ja automaatiot vastaavat viesteihin ja lähettävät viestipohjia, kun puhelut soivat edelleen puhelimesi sovelluksessa.

Not supported

Ääni- ja videopuhelut Cloud API:ssa numerolle, joka on otettu käyttöön WhatsApp Business -sovelluksella; sovelluksessa ne ovat muuttumattomia.

2,000

Päivittäinen viestirajan vähimmäismäärä uniikkeina vastaanottajina, jonka numeron on täytettävä ennen kuin se voi käyttää Calling API:a.

7 days

Kuinka kauan puhelutallenteet ja litteraatit pysyvät ladattavissa niiden webhookin toimituksen jälkeen.

wacid

Puhelun tunnuksen etuliite, arvo joka yhdistää puhelun connect-, tila- ja terminate-webhookit toisiinsa.

whatsapp_business_messaging

Oikeus, jonka sovellus tarvitsee vastaanottaakseen puhelu-webhookit, sama kuin viesteille.

Mitä calls-kenttä raportoi?

Kaikki, mitä puhelulle tapahtuu Calling API:n kautta soitettuna tai vastaanotettuna, yhdessä kentässä, jossa on tapahtuma jokaiselle vaiheelle. Yritysten aloittama puhelu tuottaa connect-tapahtuman, tilapäivityksiä ja terminate-tapahtuman. SIP:n kautta hoidetut puhelut raportoivat call_created-tapahtuman connect-tapahtuman sijaan, ilman SDP-istuntoa. Yksi liittyvä tapahtuma on muualla: kun asiakas vastaa puhelupyyntöön, vastaus tulee messages-kenttään interaktiivisena viestinä tyyppiä 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.

Miltä calls-webhook näyttää?

Sama kuori kuin kaikilla WhatsApp-webhookeilla, ja value-kohdassa on calls-taulukko, jonka field on calls. direction kertoo BUSINESS_INITIATED tai USER_INITIATED, from ja to kantavat puhelinnumerot, to_user_id asiakkaan BSUID:n, ja jompikumpi numero voi puuttua, jos asiakas käyttää käyttäjänimeä. metadata.phone_number_id tunnistaa numerosi, kuten missä tahansa muussa kentässä. Tämä on Metan Call Connect -esimerkki, paikanpitäjät sellaisina kuin Meta ne tulostaa:

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"
        }
      ]
    }
  ]
}

Mitkä kentät terminate-tapahtuma lisää?

terminate on tapahtuma, jonka useimmat järjestelmät tallentavat, koska se sulkee puhelun. Sen kentät Metan viitteen mukaan:

  • status: COMPLETED, kun puhelu päättyi ilman odottamattomia virheitä, myös vastaamattomat puhelut; FAILED, kun se ei yhdistynyt tai katkesi.
  • start_time, end_time ja duration sekunteina: vain jos toinen osapuoli vastasi.
  • errors: code, message, href ja error_data.details FAILED-puhelussa.
  • biz_opaque_callback_data: oma seurantamerkkijonosi, jos annoit sen puhelua aloittaessa tai hyväksyessä.

Toimiiko calls-webhook Coexistence-numerossa?

Metan Coexistence-opas vastaa tähän ominaisuustaulukossaan: ääni- ja videopuhelut eivät muutu WhatsApp Business -sovelluksessa, eikä niitä tueta Cloud API:ssa tällä tavalla liitetylle numerolle. Calling API:n omat esivaatimukset sanovat saman toisesta suunnasta: yrityksen numeron on oltava käytössä Cloud API:n kanssa, ei WhatsApp Business -sovelluksessa. Coexistence-numerossa asiakkaat siis soittavat kuten ennenkin, puhelu soi puhelimen sovelluksessa, eikä calls-kentässä ole mitään raportoitavaa. Yritys, joka tarvitsee puhelut ohjelmistossa, käyttää numeroa pelkästään Cloud API:ssa.

Miten yhden puhelun tapahtumat liittyvät toisiinsa?

Puhelun tunnuksella, joka alkaa wacid-etuliitteellä ja toistuu jokaisessa saman puhelun tapahtumassa. Yritysten aloittama puhelu raportoi connect-tapahtuman SDP-vastauksen kanssa, tilat RINGING ja sitten ACCEPTED tai REJECTED, ja lopuksi terminate-tapahtuman. Asiakkaan aloittama puhelu raportoi connect-tapahtuman SDP-tarjouksen kanssa, jonka pinosi vastaa, ja sitten terminate-tapahtuman. Tallenne- ja litteraattitapahtumat, kun ne on otettu käyttöön, tulevat terminate-tapahtuman jälkeen. Tallenna tapahtumat tunnuksen ja event-kentän yhdistelmällä, koska uudelleenyritykset toistavat ne eikä saapumisjärjestystä taata. Kaikki Calling API:n esivaatimukset ovat sivulla Coexistence-numeron puheluista.

Mitä tekoälysi voi tehdä Coexistence-numeron puheluille?

Se toimii chatissa, kun puhelut jäävät ihmiselle puhelimessa. easyCoexistence ei tilaa calls-kenttää eikä sillä ole puhelutyökaluja; sen liitin ja automaatiot kattavat viestit ja viestipohjat. Käytännössä tekoälyn vastaus voi kertoa asiakkaalle, milloin joku on tavoitettavissa puhelimessa ja mihin numeroon soittaa, avainsanaautomaatio voi vastata ”puhelu” tai ”puhelin” tällä tiedolla, ja omistaja vastaa puheluun WhatsApp Business -sovelluksessa kuten ennenkin.

Yleiset virheet

  • Calls-kentän tilaaminen Coexistence-numerolle ja tapahtumien odottaminen. Meta listaa soittamisen tukemattomaksi Cloud API:ssa näille numeroille.
  • Start_time- ja duration-kenttien odottaminen jokaisessa terminate-tapahtumassa. Ne ovat vain, jos puheluun vastattiin; vastaamaton puhelu päättyy silti tilaan COMPLETED.
  • Lupavastausten etsiminen calls-kentästä. Ne saapuvat messages-kenttään interaktiivisena call_permission_reply-viestinä.
  • Tallenteiden ja litteraattien jättäminen Metalle. Molemmat voi ladata 7 päivän ajan webhookin jälkeen, sitten ne ovat poissa.
Näin teet tämän EasyCoexistencen avulla

Jokaista numeroa valvotaan 24/7, mukaan lukien 14 päivän sääntö, joka katkaisee numeron, jonka sovellusta ei avata. US$ 9 laskien US$ 0,75:een numeroa kohden kuukaudessa, ja hinta laskee numeroiden lisääntyessä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Menettävätkö asiakkaat puhelupainikkeen, kun numero yhdistyy Cloud API:in Coexistencen kautta?

Metan Coexistence-opas listaa ääni- ja videopuhelut muuttumattomiksi WhatsApp Business -sovelluksessa. Asiakkaat soittavat samaan numeroon, ja omistaja vastaa sovelluksessa puhelimella.

Hinnoitellaanko Calling API samalla tavalla kuin viestit?

Ei. Metan hinnoittelusivun mukaan Calling API:lla on eri hinnoittelu, ja se viittaa erilliseen puheluhinnoitteluasiakirjaan, joten puhelumaksut eivät näy viestitilojen pricing-objektissa.

Voiko Calling API -puhelua tallentaa tai litteroida?

Kyllä, kun tallennus tai litterointi on otettu käyttöön. Puhelun jälkeen Meta lähettää call_recording_available-tapahtuman audio-median tunnuksella tai call_transcription_available-tapahtuman JSON-dokumentin tunnuksella, yleensä minuutin sisällä.

Voiko puhelu-webhook mennä eri päätepisteeseen kuin sovelluksen?

Kyllä. calls on yksi kentistä, jotka Meta sallii WhatsApp Business -tilin tai puhelinnumeron ohjata vaihtoehtoiseen URL-osoitteeseen, samoin kuin messages ja Coexistence-kentät.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu