Inbound Webhook Pagsasama

Nilikha Sa

Pinapayagan ka ng TimelinesAI na i automate ang pagpapadala ng mga mensahe ng WhatsApp bilang tugon sa mga kaganapan o pagkilos sa mga tool na ginagamit mo na: CRM, Suporta, Mga sistema ng Recruitment, atbp.

"Magpadala ng mensahe" Kaganapan

Posibleng ituro ang TimelinesAI na magpadala ng mensahe (may attachment o walang file) sa isang tiyak na contact (maaaring maging isang grupo). Kung ang maraming mga account sa WhatsApp ay konektado sa iyong workspace, posible ring tukuyin ang isang partikular na account sa WhatsApp na gagamitin para sa pagpapadala ng mensahe.

Upang mai setup ang pagsasama, ang isang may ari ng workspace ay dapat mag navigate sa screen na "Integrations / Inbound Webhooks" at makabuo ng bagong URL. Ang panlabas na sistema ay dapat mag post ng mensahe sa tiyak na format (tingnan ang mga detalye sa ibaba) sa URL na iyon.

Mga Limitasyon

  • Maximum na laki ng attachment ay 2 MB.
  • Walang agarang pagpapatunay ng format ng numero ng telepono o koneksyon ng tatanggap sa WhatsApp. Mag navigate sa Timelines UI upang i verify ang pagpapadala / basahin ang katayuan ng mga mensahe.

Pagpapadala ng mga File sa pamamagitan ng Inbound Webhooks

Pagpapadala ng isang File: Direktang Pag download kumpara sa Mga Serbisyo sa Pag host ng File

Imperative po ang pag send ng files using Direct Download Links. Pinapayagan nito ang tatanggap na aktwal na matanggap ang file.

Samantalang ang isang serbisyo sa pagho host ng file ay dapat gamitin upang maaari itong mag supply ng isang direktang link sa pag download. Ang ganitong link ay pinakamahusay na nasubok sa pamamagitan ng incognito/private browsing; sa pamamagitan ng pag paste ng link sa search bar. Kung ang file download ay nagsisimula kaagad, ang link ay katanggap tanggap. Kung sa halip, ang anumang uri ng web page ay ipinapakita, pagkatapos, ang link ay hindi maaaring gamitin para sa pagpapadala ng mga file.

Ang kaso sa mga link ng File Hosting Service ay hindi maaaring ma download ang mga file. Ano ang na download at ipinadala sa halip, ay isang pagbabahagi ng web page, na maaaring humantong sa isang "sira" na file.

Ito, sa turn, ay makakaapekto sa iyong mensahe bilang mga tatanggap ay hindi maaaring ma access ang media na ipinadala mo sa kanila, na ginagawang hindi magagamit ang mga file. Kaya, napakahalaga na matiyak mo na nagpapadala ka ng mga direktang link sa pag download, dahil papayagan nila itong ma access ang file nang walang anumang mga isyu.

Maaari mo ring patakbuhin ang pagsubok na ito sa pamamagitan ng pagpapadala ng isang webhook mensahe sa isa sa iyong mga numero ng pagsubok. Maaari mong matukoy kung paano kumilos ang file batay sa aming nirepaso dito; kung makakakuha ka ng mensahe ng error tulad ng "File is Corrupted", "Incompatible File"; o "Nabigo upang i load ang dokumento ng X", pagkatapos ng pag click sa attachment, pagkatapos ito ay isang File Hosting Service Link at dapat na mapalitan ng isang Direct Download Link.

Paggamit ng Credit

  • Ang pagpapadala ng mensahe ay kumukonsumo ng 1 credit mula sa message sending quota.
  • Ang pagpapadala ng mensahe na may hindi walang laman na teksto at attachment ay kumukonsumo ng 2 kredito mula sa quota ng pagpapadala ng mensahe.
  • Kung ang isang mensahe ay hindi maipadala (hindi wasto o hindi konektado sa numero ng WhatsApp, error sa WhatsApp server), ang quota ng pagpapadala ng mensahe ay ibabalik (karaniwan sa loob ng ilang oras).

Rate ng pagpapadala ng mensahe

  • Ang mga mensahe ay ipapadala na may random na pagkaantala ng mga 2 segundo sa pagitan ng bawat dalawang mensahe (upang maiwasan ang mga mekanismo ng pagtuklas ng spam ng WhatsApp).
  • Kung na activate mo ang mga webhooks na may dalas na mas mababa sa 2 segundo, ang mga mensahe ay nakapila at ipinadala sa labas nang may pagkaantala. Ang bawat nakapila na mensahe ay ubusin ang isang mensahe na nagpapadala ng kredito, kaya ang bilang ng mga nakapila na mensahe ay hindi maaaring lumampas sa magagamit na quota.

Webhook configuration at mga aksyon

  • "Webhook pinagana" – ay nagbibigay-daan upang huwag paganahin ang webhook nang hindi inaalis ito ganap na
  • "Bumuo ng bagong URL" – ay lumikha ng isang bagong natatanging URL, na tatanggap ng mga abiso. Hindi na magagamit ang nakaraang URL.
  • "Huling pagpapadala ng mga pagtatangka" – katayuan ng huling mga pagtatangka sa pag-activate ng webhook
  • "Download log" – isang detalyadong log ng 100 huling pagtatangka sa pag-activate, na makatutulong sa pag-troubleshoot ng mga isyu sa pag-format.

Format ng kahilingan sa Webhook

Ang Webhook ay tumatanggap ng data sa format ng JSON, sa pamamagitan ng paraan ng kahilingan sa POST.

  • "aksyon" (mandatory) – sa kasalukuyan, isa lamang ang posibleng halaga na "ipadala" ang sinusuportahan
  • "text" (sapilitan)- isang plain text UTF-8 naka-encode na mensahe na ipapadala (walang markdown suportado, maliban sa "\n" linya separator), ay maaaring iwanang walang laman, kung ang file ay tinukoy.
  • "file_url" (opsyonal) – isang URL na naa access ng publiko ng isang file na ida-download at ipapadala bilang isang attachment.
  • "file_name" (opsyonal) – isang pangalan para sa attachment (kailangang ibigay, kung tinukoy ang URL).

Ang tatanggap ay maaaring tinukoy sa pamamagitan ng pagbibigay ng isa sa mga sumusunod na parameter:

  • "chat_id" – isang id ng chat na makikita sa TimelinesAI (maaaring matagpuan sa URL ng pahina ng chat, o sa payload ng outbound webhook). Sinusuportahan nito ang pagpapadala ng mga mensahe sa isang grupo.
  • "jid" – isang WhatsApp JID na tumutukoy sa contact o grupo
  • "telepono" – isang numero ng telepono, na format ayon sa internasyonal na numero ng telepono standard, ibig sabihin:
    [+] [country code] [area code] [lokal na numero ng telepono] (halimbawa: +14151231234)
  • "chat_name" – isang eksaktong pangalan ng chat tulad ng lumilitaw sa TimelinesAI

Kung maraming WhatsApp account ang nakakonekta sa workspace, gamitin ang sumusunod na karagdagang parameter upang tukuyin ang WhatsApp account na gagamitin:

  • "whatsapp account phone" (opsyonal) – tumutukoy (bilang isang numero ng telepono, sa internasyonal na format) ang WhatsApp account sa usе para sa pagpapadala. Kung hindi natanggap, ang pinakahuling konektadong aktibong account sa WhatsApp sa workspace ay gagamitin para sa pagpapadala. Tandaan: kung ang "chat_id" parameter ay tinukoy, "whatsapp account phone" ay hindi papansinin, dahil ang bawat chat ay nakakonekta na sa isang tiyak na WhatsApp account.

Tugon ng Webhook

Sa kaso ng tagumpay (ang kahilingan ay napatunayan at tinanggap para sa pagpapadala), ang Webhook ay tutugon sa katayuan ng HTTP 200 at JSON, na naglalaman ng message_id ng nilikha na mensahe:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

 

Sa kaso ng error, ang Webhook ay tutugon sa katayuan ng HTTP 40X at JSON na may mga detalye ng error, halimbawa:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

Mga Halimbawa

Halimbawa 1 – pagpapadala ng mensahe sa pamamagitan ng partikular na WA account sa isang partikular na numero ng telepono:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

Halimbawa 2 – pagpapadala ng mensahe na may teksto at attachment sa isang chat (o grupo) na tinukoy ng id:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://timelines.ai/logo.png",
"file_name" : "logo.png"
}
admin
Pinakabagong mga post sa pamamagitan ng admin (tingnan ang lahat)
Talaan ng mga Nilalaman