Steg 2: Fånga åtkomstuppgifter och identifiera installationshändelser

Normalisera request-payloads och utvärdera därefter om den inkommande webhooken är en del av installationsflödet.

1. I Retrieve Access Details, ställ in CLIENT_ID till =[YOUR_ID] och CLIENT_SECRET till =[CONFIGURE_YOUR_API_KEY].
2. Säkerställ att fältmappningarna använder uttryck som domain = {{$json.query.DOMAIN || $json.body.domain}} och access_token = {{$json.body.AUTH_ID || $json.body.access_token}}.
3. Ställ in settingsFilePath till /data/files/hotline_files/ för att definiera var installationsinställningarna lagras.
4. I Evaluate Event Type, behåll JavaScript-logiken som sätter isInstallation och isInstallationFinished baserat på event och PLACEMENT_OPTIONS.
5. I Installation Trigger Check, konfigurera det booleska villkoret isInstallation är lika med true.

⚠️ Vanlig fallgrop: Om Bitrix payload-format ändras kan uttrycken i Retrieve Access Details returnera tomma värden, vilket bryter autentisering och fillagring.

Steg 3: Konfigurera installationsflödet och svaren

Hantera nya installationer, bind placement-hooken och svara med HTML för slutförd installation.

1. I Check Install Finished, ställ in det booleska villkoret isInstallationFinished är lika med true.
2. Koppla true-grenen till Install Finished Reply med Response Body satt till =...installation has been fully finished....
3. På false-grenen skickar Check Install Finished vidare till både Bind Placement Hook och Map Settings Payload parallellt.
4. I Bind Placement Hook, ställ in URL till =https://{{$json.domain}}/rest/placement.bind?auth={{$json.access_token}}, och behåll body-parametrarna: PLACEMENT = TASK_VIEW_TAB, HANDLER = {{$json.webhookUrl}}, TITLE = My App.
5. I Map Settings Payload, behåll JSON-objektet data och fältet updated_at satt till {{$now}}.
6. Bind Placement Hook och Write Install Settings sammanförs i Combine Install Details och returnerar sedan Install Completion Reply med Bitrix-skriptet BX24.installFinish().

⚠️ Vanlig fallgrop: Om HANDLER i Bind Placement Hook inte matchar den publika webhook-URL:en kommer Bitrix inte att rendera widgeten korrekt.

Steg 4: Lagra installationsinställningar till fil

Skapa och spara JSON-inställningsfilen som workflowet kommer att läsa vid framtida task-requests.

1. I Build Settings File, ställ in Operation till toJson och File Name till {{ $json.settingsFilePath }}/widget-app-settings.json.
2. I Write Install Settings, ställ in Operation till write och File Name till {{ $('Map Settings Payload').item.json.settingsFilePath }}/widget-app-settings.json.
3. Säkerställ att sökvägen i filsystemet finns och är skrivbar för n8n så att inställningsfilen kan skapas.

⚠️ Vanlig fallgrop: Om sökvägen /data/files/hotline_files/ saknas eller är skrivskyddad kommer Write Install Settings att misslyckas och installationsflödet bryts.

Steg 5: Läs sparade inställningar och hämta task-data

Vid icke-installationsrequests, ladda lagrade inställningar, hämta Bitrix task-data och bygg ett HTML-svar.

1. Från Installation Trigger Check (false-grenen), läs inställningsfilen med Read Saved Settings där File Selector är satt till {{ $json.settingsFilePath }}/widget-app-settings.json.
2. Tolka med Parse Saved Settings (operation fromJson) och slå sedan ihop request-data med Merge Request With Settings (mode combine, combine by combineAll).
3. Använd Process Stored Settings för att extrahera taskId från PLACEMENT_OPTIONS och outputta success för validering.
4. I Validate Saved Settings, konfigurera det booleska villkoret success är lika med true för att routa giltiga requests till Fetch Task Information.
5. I Fetch Task Information, ställ in URL till =https://{{ $json.originalRequest.query.DOMAIN }}/rest/tasks.task.get?auth={{ $json.originalRequest.access_token }} och JSON Body till {{ $json.originalRequest.body.PLACEMENT_OPTIONS }}.
6. I Format Task Payload, behåll logiken som bygger HTML-tabellen och skicka vidare till Render Task View med Response Body som innehåller {{$json.taskHtml}}.

Steg 6: Lägg till svar för felhantering

Returnera en användarvänlig felsida när inställningar saknas eller är ogiltiga.

1. Från false-grenen i Validate Saved Settings, koppla till Send Error Page.
2. Behåll HTML:en i Send Error Page som instruerar användaren att installera om applikationen när inställningar saknas eller har löpt ut.

Steg 7: Testa och aktivera ert workflow

Verifiera både installations- och task-renderingsflöden innan ni slår på körning i produktion.

1. Använd Execute Workflow med en exempel-payload från Bitrix för att bekräfta att Install Completion Reply returnerar HTML:en för slutförd installation.
2. Skicka en icke-installationsrequest som innehåller PLACEMENT_OPTIONS för att verifiera att Render Task View returnerar HTML-tabellen med task-fälten.
3. Bekräfta felvägen genom att tillfälligt byta namn på inställningsfilen för att se att Send Error Page returnerar meddelandet om ominstallation.
4. När testerna lyckas, sätt workflowet till Active så att endpointen för Bitrix Incoming Webhook är live.