පුරනය වන්නනොමිලේ trial කාලය ආරම්භ කරන්න
Meta Tech Provider

WhatsApp user_preferences webhook එක: පාරිභෝගිකයෙක් අලෙවිකරණ පණිවිඩ නවත්වන හෝ නැවත ආරම්භ කරන විට

user_preferences webhook එක ව්‍යාපාරයකට දන්වන්නේ WhatsApp පරිශීලකයෙක් 'දීමනා සහ නිවේදන' සැකසුම හරහා ඔවුන්ගේ අලෙවිකරණ පණිවිඩ නවත්වා හෝ නැවත ආරම්භ කර ඇති බවයි. සෑම සිදුවීමකම category marketing_messages, value (stop හෝ resume), විස්තර වාක්‍යයක්, පරිශීලකයාගේ wa_id සහ BSUID, සහ Unix timestamp එකක් අඩංගු වේ. එම සැකසුමේ ඇති උනන්දුවක් ඇත සහ උනන්දුවක් නැත ප්‍රතිපෝෂණය මෙම webhook එක ක්‍රියාත්මක නොකරයි.

easyCoexistence ඔබේ WhatsApp Business app අංකය Coexistence හරහා Meta ගේ Cloud API වෙත සම්බන්ධ කරයි, එබැවින් ඔබේ AI සහ automations යෙදුමේ ඔබ තබා ගන්නා අංකය මත ක්‍රියා කරයි.

2

මනාපයකට ගත හැකි අගයන්: stop සහ resume, දෙකම marketing_messages category එකේ.

131050

ඔබේ අලෙවිකරණ template එකක් ඔබේ අලෙවිකරණ පණිවිඩ නවත්වා ඇති පරිශීලකයෙකුට යවන විට ලැබෙන failed status කේතය.

Default callback

මෙය WhatsApp Business Account හෝ අංකයකට override කළ හැකි field එකක් නොවේ.

whatsapp_business_management

messages සහ calls හැර අනෙක් webhooks සඳහා app එකට අවශ්‍ය permission, user_preferences ඇතුළුව.

user_preferences webhook එක ක්‍රියාත්මක කරන්නේ කුමක්ද?

පාරිභෝගිකයෙක් WhatsApp හි 'දීමනා සහ නිවේදන' විවෘත කර ඔබේ ව්‍යාපාරයෙන් අලෙවිකරණ පණිවිඩ නවත්වීමට, පසුව නැවත ලබාගැනීමට තෝරන විට පමණි. ඒ ක්‍රියා දෙක පමණක් මේ සිදුවීම් ඇති කරයි. එම සැකසුමේම ඇති උනන්දුවක් ඇත හෝ උනන්දුවක් නැත ලෙස ලකුණු කිරීම webhook එකක් යවන්නේ නැත, නමුත් උනන්දුවක් නැත මගින් එම පාරිභෝගිකයා සමග ඇති පරිශීලකයා අනුව අලෙවිකරණ සීමාව අඩු කළ හැක. එය තවත් තිරයක් ද විවෘත කරයි, සියලු අලෙවිකරණ පණිවිඩ නවත්වන්න යෝජනා කරමින්. ඔවුන් ඉන්පසු නවත්වන්න තට්ටු කළ විට පමණක් user_preferences ක්‍රියාත්මක වේ.

payload එකේ අඩංගු වන්නේ කුමක්ද?

contacts array එකක් ඉදිරියෙන්, user_preferences යන field නාමය යටතේ user_preferences array එකක්. මෙහි timestamp එක integer එකක් වන අතර status webhooks ඒවා string ලෙස යවයි. පාරිභෝගිකයා username භාවිතා කර දුරකථන අංකය බෙදාගත නොහැකි විට wa_id ඉවත් කරයි, ව්‍යාපාර-පරිමාණ user IDs සක්‍රිය නැති විට user_id ඉවත් කරයි, parent BSUIDs සක්‍රිය නොවන තාක් parent_user_id ඉවත් කරයි. නැවත ආරම්භයේ Meta ගේ උදාහරණය:

Meta's example: a customer resumes marketing messages
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "contacts": [
              {
                "wa_id": "16505551234",
                "user_id": "US.13491208655302741918",
                "parent_user_id": "US.ENT.506847293015824"
              }
            ],
            "user_preferences": [
              {
                "wa_id": "16505551234",
                "user_id": "US.13491208655302741918",
                "parent_user_id": "US.ENT.506847293015824",
                "detail": "User requested to resume marketing messages",
                "category": "marketing_messages",
                "value": "resume",
                "timestamp": 1731705721
              }
            ]
          },
          "field": "user_preferences"
        }
      ]
    }
  ]
}

නවත්වීමක් ලැබුණු විට ඔබේ පද්ධතිය කළ යුත්තේ කුමක්ද?

එය පාරිභෝගිකයා සමග සම්බන්ධ කර, නැවත ආරම්භයක් ලැබෙන තුරු සෑම අලෙවිකරණ යැවීමකින්ම ඉවත් කරන්න. detail field එකේ "User requested to stop marketing messages" හෝ "User requested to resume marketing messages" ලෙස කියවෙයි, නමුත් කේතය කියවිය යුත්තේ value එකයි.

  • මනාපය BSUID සහ දුරකථන අංකය යන දෙකෙන්ම ගබඩා කරන්න, මක්නිසාද ඕනෑම සිදුවීමක එකක් නොතිබිය හැකි නිසා.
  • අලෙවිකරණ template යැවීම් වලින් පාරිභෝගිකයා බැහැර කරන්න; Meta එසේ ප්‍රතික්ෂේප කරන නිසා 131050 සමඟ ඒවා ප්‍රතික්ෂේප කරයි.
  • පාරිභෝගිකයා අනුව පමණක් යොදන්න: Meta කිසිදා parent BSUID මට්ටමින් මනාපයක් යොදන්නේ නැත.
  • නැවත ආරම්භයකදී බැහැර කිරීම ඉවත් කර, Meta ගේ opt-in policy අවශ්‍ය කරන පරිදි ඔබේ තමන්ගේම opt-in වාර්තාව තබා ගන්න.

user_preferences ඔබේ server එකට කිසිදා නොපැමිණියහොත් කුමක් වේද?

Meta නවත්වීම කෙසේ හෝ බලාත්මක කරයි, එබැවින් webhook එක නැති වීම අසාර්ථක යැවීමක් පමණක් වැය කරයි, policy උල්ලංඝනයක් නොවේ. නවත්වා ඇති අයෙකුට අලෙවිකරණ template එකක් යවන විට, API ඉල්ලීම පිළිගනී, පණිවිඩය යවන්නේ නැත, සහ status webhook එකක් failed, කේතය 131050 සහ මාතෘකාව "Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business" සමඟ යවයි. එම අසාර්ථකත්වය නවත්වීම් සිදුවීමක් ලෙස හරියටම සලකන්න: එය වාර්තා කර, එම පාරිභෝගිකයාට ඉදිරි අලෙවිකරණ යැවීම් වළක්වන්න.

easyCoexistence හරහා සම්බන්ධ අංකයක මෙය කෙසේ ක්‍රියා කරයි?

user_preferences යනු Meta විසින් destination override කිරීමට ඉඩ දෙන field වලින් එකක් නොවේ, එබැවින් එය ගිණුමට subscribe වූ app එකේ default callback එකට පමණක් Meta යවයි. easyCoexistence හරහා සම්බන්ධ අංකයක් සඳහා, එම app එක easyCoexistence ගේ වන අතර, එය අද user_preferences වෙත subscribe වී නැත, එබැවින් සිදුවීම සෘජු destination එකකට හෝ Forward URL එකකට නොපැමිණේ. 131050 failed status එක පැමිණේ, මක්නිසාද එය messages field එක හරහා ගමන් කරයි.

ඔබේ AI send_template සමඟ අලෙවිකරණ template යවන්නේ නම්, නවත්වන ලැයිස්තුව ඔබේම පද්ධතියේ තබාගෙන පළමුව එය පරීක්ෂා කරන්න: easyCoexistence එවැනි ලැයිස්තුවක් තබා ගන්නේ නැත.

සාමාන්‍ය වැරදි

  • උනන්දුවක් නැත නවත්වීමක් ලෙස සැලකීම. එය webhook එකක් යවන්නේ නැත, යැවීම නවත්වන්නේද නැත, නමුත් එම පාරිභෝගිකයා සඳහා අලෙවිකරණ සීමාව අඩු කළ හැක.
  • මනාප wa_id පමණක් මත යතුරු කිරීම. username ඇති, අංකය බෙදාගත නොහැකි පාරිභෝගිකයන් සඳහා එය ඉවත් වේ; BSUID ද ගබඩා කරන්න.
  • Parent BSUID එකක් යටතේ සියලුම අයට නවත්වීම යෙදීම. Meta මනාප කිසිදා parent මට්ටමින් නොයොදයි, සෑම පරිශීලකයාටම වෙන වෙනම.
  • 131050 ට පසු නැවත උත්සාහ කිරීම, එය නවත්වීමක් ලෙස වාර්තා කිරීම වෙනුවට. සෑම retry එකක්ම එකම ආකාරයෙන් අසාර්ථක වේ.
EasyCoexistence සමඟ මෙය කිරීම

ඒ හරහා යවන අලෙවිකරණ template ඔබේම WhatsApp Business Account එකෙන් යන අතර, පාරිභෝගිකයෙක් නවත්වා ඇති බව වාර්තා කරන failed status එක ඔබේ server එකට සෘජුවම හෝ අත්සන් කළ forwards ලෙස පැමිණේ. එක් අංකයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, අංක එකතු කරන විට අඩු වෙයි, පළමු දින 3 නොමිලේ trial කාලය සමඟ.

නිතර අසන ප්‍රශ්න

නවත්වීමක් පාරිභෝගිකයා ඔබට ලියූ පණිවිඩවලට පිළිතුරු දීම ද අවහිර කරයිද?

Meta ගේ ලේඛනය නවත්වීම අලෙවිකරණ පණිවිඩ ආවරණය කරන බව විස්තර කරන අතර, එය ලබා දෙන දෝෂය අලෙවිකරණ පණිවිඩ ලෙස නම් කරයි. ඔබට ලිව්ව පාරිභෝගිකයෙකුට ඇති පිළිතුරු service පණිවිඩ වන අතර, ඒවා වෙනම කාණ්ඩයකි.

ව්‍යාපාරය අවහිර කිරීම user_preferences ක්‍රියාත්මක කරයිද?

නැත. webhook එක ක්‍රියාත්මක වන්නේ Offers and announcements සැකසුමේ නවත්වීම සහ නැවත ආරම්භය සඳහා පමණි. අවහිර කිරීම වෙනම ක්‍රියාවක් වන අතර මෙම field එකේ වාර්තා නොවේ.

නැවත ආරම්භය opt-in ලෙස ගණනය වේද?

එයින් අදහස් වන්නේ පාරිභෝගිකයා නැවතත් ඔබේ අලෙවිකරණ පණිවිඩ ලැබීමට තෝරාගත් බවයි. Meta ගේ policy යටතේ ඔබේ තමන්ගේ opt-in වගකීම් තවමත් අදාළ වන බැවින්, එම පාරිභෝගිකයා ඔබෙන් ඇසීමට කෙසේ සහ කවදා එකඟ වූවාද යන වාර්තාව තබා ගන්න.

මම කුමන webhook field එකට subscribe විය යුතුද?

user_preferences, App Dashboard හි WhatsApp > Configuration යටතේ, WhatsApp Business Account එකට subscribe වූ app එකේ. එය messages වලින් වෙනම field එකක් වන අතර whatsapp_business_management අවශ්‍ය වේ.

තවදුරටත් කියවන්න

WhatsApp පණිවිඩයක් අසාර්ථක වූයේ ඇයි: failed status සහ දෝෂ කියවීමfailed status යනු Meta ට ඔබේ WhatsApp පණිවිඩය යැවීමට හෝ බාරදීමට නොහැකි වූ බවයි. errors array සහ 131047, 131049, 131050 වැනි කේත කියවා කළ යුතු දේ දැනගන්න.WhatsApp webhook statuses: sent, delivered, read සහ failedWhatsApp ඔබ යැවූ පණිවිඩයට සිදු වූ දේ වාර්තා කරන ආකාරය: statuses array එක, status අගයන්, fields, wamid සහ Meta හි සත්‍ය payload.WhatsApp දෝෂය 131050: පරිශීලකයා ඉවත් වී ඇතදෝෂය 131050 යනු ලබන්නා ඔබේ ව්‍යාපාරයෙන් පණිවිඩ නොලැබීමට තෝරාගෙන ඇති බවයි. එය මගහැරීමට නොව, ගරු කිරීමට හේතුව මෙන්න.ව්‍යාපාරයක් ආරම්භ කරන පණිවිඩ සඳහා WhatsApp opt-in අවශ්‍යතාව්‍යාපාරයක් කෙනෙකුට පණිවිඩ යැවීමට පෙර Meta ප්‍රතිපත්තිය ඉල්ලන දේ: කොන්දේසි දෙක, opt-in එකේ අන්තර්ගතය සහ opt-out නීති.templates සහ opt-in සමඟ WhatsApp marketing automationMeta අනුමත කරන ආකාරයට WhatsApp marketing ස්වයංක්‍රීය කරන්න: opt-in, අනුමත templates, ස්වයංක්‍රීය පිළිතුරු සහ ඉහළ තත්ත්වය.WhatsApp webhook ක්ෂේත්‍ර සහ ඒවා යොමුවන තැන්Coexistence සම්බන්ධතාවයක් භාවිත කරන webhook ක්ෂේත්‍ර අට, ඒවා රැගෙන යන දේ සහ endpoint එකට යන හෝ නිරීක්ෂණයට තබන ඒවා.

ආරම්භ කිරීමට සූදානම්ද?

WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්‍රියා කරයි.

නොමිලේ trial කාලය ආරම්භ කරන්න

සත්‍යාපනය කළේ