Қателер, n8n және шектеулер

Қателер { error, description, data } түрінде беріледі. Негізгі кодтар:

• channel_not_found (404) — channel_id табылмады, өз компанияңызға тиесілі емес, кілтке таңдалмаған немесе өшірілген.
• not_found (404) — мұндай жіберу, жазылым немесе жеткізілім жоқ.
• forbidden (403) — кілтте бұл әрекетке құқық жоқ («Кілт құқықтары» бөлімін қараңыз).
• line_license_expired (402) — желі лицензиясының мерзімі аяқталды; желіні ұзартыңыз.
• idempotency_conflict (409) — client_msg_id басқа жіберуге қолданылған.
• replay_unavailable (409) — қолжетімділігі сақталған сәтсіз жеткізілімді ғана қайталауға болады.
• outside_24h_window (422) — 24 сағаттық мерзім аяқталды. Кәдімгі мәтін орнына шаблон жіберіңіз.
• invalid_message (422) — арна мазмұнды қабылдамады; шаблон табылмады не APPROVED емес; note / voice файл түріне сәйкес емес; немесе chat_type / reply_to арнаға не диалогке сәйкес емес.
• template_error (422) — Meta шаблон құруды не өзгертуді қабылдамады. Себебі description, кодтары data өрісінде.
• invalid_request (400) — сұрау денесі, параметрлері не тақырыбы тексеруден өтпеді (оның ішінде media_url POST /media/ арқылы алынбаған және Idempotency-Key жоқ). Өрістер бойынша түсіндірме data.fields ішінде.
• invalid_webhook_url (400) — URL HTTPS емес немесе жеке желідегі мекенжай.
• storage_quota_exceeded (413) — файл қоймасының квотасы таусылды.
• unauthorized (401) — кілт берілмеген, қате немесе күшін жойған.
• rate_limited (429) — сұрау жиілігі шегінен асты. Күту уақыты data.retry_after_seconds және Retry-After тақырыбында.
• method_not_allowed (405) — бұл мекенжай осы әдісті қабылдамайды.
• internal_error (500) — серверімізде қате болды. Сол client_msg_id мәнімен қайта сұрағанда хабарлама қайталанбайды.

Жиілік лимиттері жылжымалы бір минутқа, сұрау түрлері бойынша бөлек есептеледі. Төменде әдепкі мәндер; жобаңыз үшін оларды көтеруге болады.

Әр кілттің өз лимиті бар, ал тенанттың ортақ шегі жаңа кілттер арқылы өткізу қабілетін көбейтуге жол бермейді. Шаблон денсаулығын тексеру бір кілтке бір уақытта екеуден аспайды. Шектен ассаңыз, 429 қатесімен бірге Retry-After тақырыбы келеді. Қайта сұрауды осы уақыт өткеннен кейін жасаңыз.

n8n үшін жеке дайын түйін әзірге жоқ. Стандартты Webhook түйіні кіріс оқиғаларды қабылдайды; HMAC тексеру үшін raw / binary body қосыңыз. HTTP Request түйіні жауаптарды Authorization: Bearer тақырыбымен жібереді.

1. Webhook түйінінде raw / binary body қосып, X-Wahub-Signature-V2 мәнін бастапқы сұрау денесімен салыстырыңыз.
2. HTTP Request түйінінен /messages/ мекенжайына Authorization: Bearer gw_… тақырыбымен POST сұрауын жіберіңіз.

Интеграцияны жоспарлағанда мына шектеулерді ескеріңіз:

• Gateway API арқылы шаблон құру: тек мәтіндік header, body және footer бөліктері қолжетімді; батырмалар мен медиа тақырыптары қосылмайды.
• Боттан операторға басқаруды автоматты беру жоқ: екеуі бір уақытта жауап бере алады. Жауап беру тәртібін өз интеграцияңызда келісіңіз.
• Бір арнаға бірнеше сервис жазыла алады; оқиға бәріне жеткізіледі.
• Файл серверіміздегі жол арқылы беріледі және сол API кілтін талап етеді; жалпыға ашық сілтеме берілмейді.