Steg 2: anslut autentiseringsvariabler för boten

Mappa inkommande auth-värden och lägg till era applikationsuppgifter för efterföljande API-anrop.

1. Lägg till noden Assign Auth Variables och aktivera Include Other Fields.
2. Ställ in CLIENT_ID på [YOUR_ID] och CLIENT_SECRET på [CONFIGURE_YOUR_API_KEY].
3. Ställ in application_token på {{ $json.body['auth[application_token]'] }}.
4. Ställ in domain på {{ $json.body['auth[domain]'] }}.
5. Ställ in access_token på {{ $json.body['auth[access_token]'] }}.

Steg 3: validera tokens och routa händelser

Verifiera applikationstoken och styr varje händelse till rätt flöde.

1. Konfigurera Verify App Token med ett villkor där Left Value är {{ $json.CLIENT_ID }} och Right Value är {{ $json.application_token }}.
2. Behåll det sekundära alltid-sanna villkoret (vänster 1 är lika med höger 1) om ni vill kunna kringgå kontrollen under test.
3. Koppla true-utgången från Verify App Token till Event Router och false-utgången till Return Error Reply.
4. I Event Router skapar ni regler som kontrollerar {{ $json.body.event }} för ONIMBOTMESSAGEADD, ONIMBOTJOINCHAT, ONAPPINSTALL och ONIMBOTDELETE.

Steg 4: sätt upp hantering för meddelanden och installation

Transformera inkommande händelser till rätt payloads för bot-registrering och meddelandesvar.

1. I Transform Chat Message behåller ni logiken som läser data[PARAMS][MESSAGE] och returnerar DIALOG_ID, MESSAGE, AUTH och DOMAIN.
2. I Handle Join Event säkerställer ni att den returnerar ett välkomstmeddelande med DIALOG_ID, MESSAGE, AUTH och DOMAIN.
3. I Prepare Install Payload ställer ni in CODE på LocalExampleBot och uppdaterar PROPERTIES.EMAIL från [YOUR_EMAIL] till er riktiga e-postadress.
4. Bekräfta att Prepare Install Payload använder handler_back_url från item.json.webhookUrl så att boten skickar händelser tillbaka till er webhook.

Steg 5: konfigurera utgående API-anrop

Skicka bot-registrering och meddelandesvar till Bitrix24-endpoints.

1. I Register Bot Request ställer ni in URL på =https://{{ $json.DOMAIN }}/rest/imbot.register?auth={{$json.AUTH}} och behåller Method som POST.
2. Ställ in body-parametrar i Register Bot Request: EVENT_MESSAGE_ADD, EVENT_WELCOME_MESSAGE och EVENT_BOT_DELETE till {{$json.handler_back_url}}.
3. Ställ in PROPERTIES på {{ { NAME: 'Bot', LAST_NAME: 'Example', COLOR: 'AQUA', EMAIL: '[YOUR_EMAIL]', PERSONAL_BIRTHDAY: '2020-07-18', WORK_POSITION: 'Report on affairs', PERSONAL_GENDER: 'M' } }} och ersätt [YOUR_EMAIL].
4. I Dispatch Chat Message ställer ni in URL på =https://{{$json.DOMAIN}}/rest/imbot.message.add?auth={{$json.AUTH}} och mappar DIALOG_ID, MESSAGE och AUTH till {{ $json.DIALOG_ID }}, {{ $json.MESSAGE }} och {{ $json.AUTH }}.
5. I Dispatch Welcome Message använder ni samma URL och body-mappningar som Dispatch Chat Message.
6. Lämna Handle Bot Removal som en noOp tills vidare; den fungerar som en platshållare för framtida städåtgärder.

Steg 6: lägg till felhantering

Returnera ett tydligt fel när applikationstoken är ogiltig.

1. Konfigurera Return Error Reply med Respond With inställt på json.
2. Ställ in Response Code på 401.
3. Ställ in Response Body på {{ "result": false, "error": "Invalid application token" }}.
4. Säkerställ att false-utgången från Verify App Token är kopplad till Return Error Reply.

Steg 7: testa och aktivera ert workflow

Verifiera varje händelseflöde och aktivera workflowet för produktion.

1. Använd test-URL:en i Incoming Webhook Intake för att skicka en exempel-payload med body.event satt till ONIMBOTMESSAGEADD och bekräfta att Dispatch Chat Message körs.
2. Skicka en test-payload med body.event satt till ONIMBOTJOINCHAT och bekräfta att Dispatch Welcome Message körs.
3. Skicka en test-payload med body.event satt till ONAPPINSTALL och verifiera att Register Bot Request returnerar ett lyckat svar.
4. Trigga ett misslyckat token-test genom att ändra application_token och bekräfta att Return Error Reply svarar med 401 och fel-JSON:en.
5. När testerna passerar växlar ni workflowet till Active för att börja hantera live-händelser.