Kwa nini ujumbe wa WhatsApp haukufika: kusoma hali ya failed na makosa yake
Webhook ya hali ya failed inamaanisha Meta haikuweza kutuma au kufikisha ujumbe ambao biashara ilituma kupitia API. Inafika kwenye uwanja wa messages ikiwa na status failed na orodha ya errors yenye code, title, message, error_data.details na href. Code ndiyo inayoonyesha sababu: 131047 dirisha la huduma limefungwa, 131026 haiwezi kufikishwa, 131049 kikomo cha masoko, 131050 masoko yamesimamishwa, 131042 tatizo la malipo.
easyCoexistence inaunganisha nambari yako ya programu ya WhatsApp Business na Cloud API ya Meta kupitia Coexistence, na inapeleka hali za failed kwa seva yako, moja kwa moja au kama uelekezaji uliosainiwa wakati otomatiki zimewashwa.
Zimepita zaidi ya saa 24 tangu mpokeaji alipojibu mara ya mwisho; suluhisho la Meta ni kutuma kiolezo badala yake.
Haikufikishwa ili kulinda ushiriki mzuri wa mfumo ikolojia; subiri angalau saa 24 kabla ya kutuma tena kiolezo cha masoko.
Mpokeaji alichagua kusimamisha ujumbe wa masoko kutoka kwa biashara; Meta inasema usijaribu tena.
Hali ya failed haina uwanja wa contacts, kwa hiyo unganisha kushindwa kupitia statuses.id.
Meta inatoza kwa ujumbe unaofikishwa, si kwa ujumbe unaotumwa tu.
Hali ya failed inaonekanaje?
Kama hali nyingine yoyote, pamoja na errors. Uwanja wa contacts haupo, recipient_user_id haujumuishwi ikiwa ujumbe ulitumwa kwa nambari ya simu, na hakuna kitu cha pricing. title na message vina maandishi yale yale, error_data.details inaeleza kwa sentensi moja, na href inaelekeza kwenye orodha ya misimbo ya makosa ya Meta. Hii ni mfano wa Meta wenyewe, kiolezo cha masoko kilichosimamishwa na kikomo cha kila mtumiaji:
{
"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"
}
]
}
]
}Ni misimbo ipi ya makosa inarudi mara nyingi, na inamaanisha nini?
Meta hurudisha makosa kwenye jibu la kutuma, kwenye hali ya failed, au kwenye zote mbili, kwa hiyo msimbo uleule unaweza kufika kwa njia yoyote, na kishughulikiaji chako kinapaswa kusoma sehemu zote mbili. Haya ni misimbo inayoeleza ujumbe mwingi usiofika, pamoja na sababu ya Meta yenyewe na hatua ya kwanza ya kujaribu; orodha kamili iko kwenye marejeo ya misimbo ya makosa ya Meta:
Kishughulikiaji chako kifanye nini kwa kila aina ya kushindwa?
Panga msimbo kulingana na hatua inayofuata kabla ya chochote kujaribu tena. Kujaribu tena kwa kila kitu hugeuza kujiondoa kwa masoko kuwa kushindwa mara kwa mara na kunaweza kurefusha kizuizi, huku kuacha hitilafu ya muda kunapoteza ujumbe ambao ungefika dakika moja baadaye.
- Jaribu tena kwa kuongeza muda wa kusubiri (backoff): 131000 haijulikani, 131016 huduma haipatikani, 130429 kikomo cha kasi kimefikiwa.
- Subiri kwanza: 131049, angalau saa 24, kwa sababu majaribio ya mapema yanaweza kumzuia mtumiaji huyo kwa hadi saa 24 zaidi.
- Badilisha ujumbe: 131047 inahitaji kiolezo kilichoidhinishwa, kwa sababu dirisha la saa 24 limefungwa.
- Simamisha kwa mteja huyu: 131050, hadi itakapopokea arifa ya resume kupitia
user_preferences. - Rekebisha akaunti au maudhui: 131042 malipo, 131031 akaunti imezuiwa, 131053 midia.
Ni kushindwa gani kunaonekana tu kama hali ya failed?
Ni zile ambazo Meta huamua baada ya kukubali ombi. Kutuma hurudisha wamid, na kukataliwa hufika baadaye kwenye webhook hii. Meta haiwasilishi violezo vya masoko kwa watumiaji wa WhatsApp wenye nambari za simu za Marekani (+1 yenye msimbo wa eneo wa Marekani), kiolezo cha masoko kwa mteja aliyesimamisha ujumbe wa masoko huchakatwa kisha huripotiwa kama failed kwa 131050, na kikomo cha masoko cha kila mtumiaji hutoa 131049 kwa njia hiyo hiyo.
Ikiwa nambari haina kituo cha webhook, kushindwa huku hakuonekani popote, na ujumbe unaonekana kama umetumwa tu. Kwa mpangilio kamili wa ukaguzi mteja anapokosa ujumbe, angalia ukurasa wa ujumbe wa WhatsApp API ambao haukufika.
Nini kinabadilika kwenye nambari ya Coexistence?
Mambo mawili ni muhimu. Kwanza, dirisha la saa 24 linahusu API pekee. Mwongozo wa Coexistence wa Meta unasema ujumbe unaotumwa kutoka programu ya WhatsApp Business hauko chini ya dirisha la huduma kwa wateja, kwa hiyo baada ya 131047 mmiliki bado anaweza kumjibu mteja huyo kutoka simuni, wakati mfumo wako unatuma kiolezo kilichoidhinishwa.
Pili, kasi ya ujumbe imewekwa. Nambari inayotumika kwenye programu na API kwa wakati mmoja hutuma upeo wa ujumbe 20 kwa sekunde, na kuzidi hapo hurudisha 130429. Kila kitu kingine kinasomeka kama kwenye nambari yoyote ya Cloud API: uwanja uleule, orodha ile ile ya errors, misimbo ile ile.
Otomatiki na AI yako huonaje kushindwa?
Inategemea ni lini Meta inasema hapana. Kukataliwa wakati wa kutuma, kama 131047, kunashindwa hatua ya otomatiki: mzunguko unaonyesha Imeshindikana kwenye kichupo cha Runs pamoja na ujumbe wa Meta, na mmiliki anapata barua pepe ili amjibu mteja huyo mwenyewe. Otomatiki pia huangalia dirisha kabla ya kutuma jibu huru na kuruka kwa window_closed badala ya kujaribu.
Kushindwa ambavyo Meta huripoti baadaye hufika kama hali ya failed kwenye Forward URL au kituo cha moja kwa moja, na mzunguko unabaki kama ulivyokuwa. AI iliyotuma kiolezo kupitia kiunganishi cha MCP huona wamid na "sent: true"; uliza mfumo wako hali ya wamid hiyo, au mwambie msaidizi aendeshe get_number_health ujumbe mwingi unaposhindwa kwa wakati mmoja.
Makosa ya kawaida
- Kujaribu 131050 tena kwenye kitanzi. Mteja amesimamisha ujumbe wa masoko, kwa hiyo kila jaribio linashindwa vile vile hadi aanze tena.
- Kutuma tena kiolezo cha masoko cha 131049 ndani ya saa chache. Meta inaomba angalau saa 24, na majaribio ya mapema yanaweza kumzuia mtumiaji huyo kwa hadi saa 24 zaidi.
- Kurekodi title pekee. error_data.details ina sababu mahususi, kwa hiyo hifadhi code na details pamoja na wamid.
- Kuendesha bila kituo cha webhook na kupima kufikishwa kwa jibu la kutuma, ambalo linasema tu Meta imekubali ujumbe.
Jibu la otomatiki likikataliwa wakati wa kutuma, mzunguko unaonyesha kosa la Meta na unapata barua pepe, na kila nambari inafuatiliwa saa 24 kwa siku, siku 7 kwa wiki, kwa kukatika na kushuka kwa ubora. Kuanzia US$ 9 hadi US$ 0.75 kwa kila nambari iliyounganishwa kwa mwezi, inashuka kadri unavyoongeza nambari, na siku 3 za kwanza ni bure.
Maswali yanayoulizwa mara kwa mara
Je, Meta hutoza ujumbe ulioshindwa?
Kurasa za bei za Meta zinasema inatoza kwa ujumbe unaofikishwa, si kwa ujumbe unaotumwa tu. Hali ya failed haibebi kitu cha pricing. Malipo huenda kwenye Akaunti ya Biashara ya WhatsApp ya biashara yenyewe, na easyCoexistence haiweki nyongeza ya bei kamwe.
Je, 131026 inamaanisha mteja amezuia biashara?
Orodha ya Meta ya 131026 inataja sababu nyingine: nambari haipo kwenye WhatsApp, mpokeaji hajakubali masharti ya hivi karibuni, au toleo lake la WhatsApp ni la zamani mno. Meta inapendekeza kumwuliza mteja kupitia njia nyingine ili akague hayo.
Kwa nini recipient_user_id huonekana kwenye baadhi ya kushindwa na si kwenye nyingine?
Meta huiacha kwenye hali ya failed ujumbe ulipotumwa kwa nambari ya simu. Ulipotuma kwa BSUID ya mteja, kushindwa huijumuisha, na recipient_id ndiyo inaweza kukosekana.
Je, ujumbe unaweza kushindwa baada ya kufikishwa?
Marejeo ya Meta yanaeleza failed kama kushindwa kutuma au kufikisha. Ujumbe ukishafika kwenye kifaa, hali zinazofuata unazoweza kutarajia ni read, au played kwa ujumbe wa sauti.
Endelea kusoma
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoImethibitishwa kwenye