n8n Zendesk-integration: noder, inloggningsuppgifter och exempelarbetsflöden

Zendesk-noden läser eller ändrar data i Zendesk som ett steg i ett arbetsflöde. n8n:s dokumentation grupperar dess operationer efter resurs.

Ett beteende brukar överraska. När du använder Update Ticket och fyller i fältet Tag Names or IDs säger n8n:s dokumentation att hela listan med taggar på ärendet ersätts, så alla taggar som du inte tar med tas bort. Det följer hur Zendesk API hanterar tagguppdateringar som standard. Dokumentationen listar tre sätt att komma runt det: hämta de aktuella taggarna och slå ihop dem med de nya innan du uppdaterar, använd noden HTTP Request med Zendesks egenskap additional_tags, eller anropa ärendets tags-endpoint. De två sista lägger till taggar utan att ta bort befintliga.

Om noden inte stöder en operation du behöver, använd noden HTTP Request, ställ in Authentication på Predefined Credential Type och välj din Zendesk-credential. Anropet återanvänder då samma anslutning som Zendesk-noden.

Noderna Zendesk och Zendesk Trigger använder samma credential, och n8n stöder två sätt att autentisera. Båda kräver din subdomän, som är delen av din Zendesk-URL mellan https:// och .zendesk.com.

• API-token: i Zendesk Admin Center öppnar du Apps and integrations och sedan APIs, och aktiverar tokenåtkomst för Zendesk API. Lägg till en token med en beskrivning och kopiera den. I n8n anger du subdomänen, mejladressen du loggar in i Zendesk med och token.
• OAuth2: i Zendesk Admin Center skapar du en OAuth-klient under Apps and integrations och sedan APIs. Klistra in n8n:s OAuth-callback-URL i klientens fält för omdirigerings-URL. Kopiera klientens unika identifierare till Client ID i n8n och dess hemlighet till Client Secret, lägg till subdomänen, spara och anslut ditt Zendesk-konto.

Det finns två sätt att starta ett arbetsflöde i n8n från Zendesk. Zendesk Trigger-noden startar ett arbetsflöde när händelser i Zendesk matchar de villkor du anger i noden. I exemplet i n8n:s dokumentation filtrerar den på ärenden med status Open, och arbetsflödet körs när du har aktiverat det.

Alternativet är att bygga kopplingen själv. I Zendesk Admin Center går du till Apps and integrations och sedan Webhooks, skapar en webhook, väljer Trigger or Automation som anslutningsmetod och riktar den mot Production URL för en Webhook-nod i n8n. Lägg sedan till åtgärden Notify webhook i en trigger eller automatisering i Zendesk och skriv payloaden, som inte får överstiga 16 000 tecken. På så sätt ligger villkoren kvar i Zendesks affärsregler och du kan välja exakt vilka fält som ska skickas.

Om du använder en webhook, kontrollera att anropen verkligen kommer från Zendesk. Zendesk skickar två headrar, X-Zendesk-Webhook-Signature och X-Zendesk-Webhook-Signature-Timestamp. Signaturen är base64(HMACSHA256(timestamp + body)) skapad med webhookens signeringshemlighet, som du kan visa på webhookens detaljsida eller hämta via API:et. Räkna om den i ditt arbetsflöde och avvisa anrop som inte stämmer. Zendesk säger också att samma åtgärd kan anropa en webhook mer än en gång, så gör arbetsflödet säkert att köra två gånger för samma ärende.

Webhook-noden kan svara direkt, när den sista noden är klar eller via en separat Respond to Webhook-nod. För längre arbetsflöden ger ett direkt svar Zendesk ett snabbt besked medan resten av arbetet fortsätter.

Här är ett vanligt mönster, beskrivet steg för steg. Det visar hur noderna hänger ihop. Det är inte ett kundcase från TascaLab.

1. Trigger: en Zendesk Trigger-nod, eller en Webhook-nod som matas av en trigger i Zendesk som körs när ett ärende skapas. Skicka åtminstone ärende-ID:t.
2. Hämta: en Zendesk-nod med resursen Ticket hämtar hela ärendet, inklusive ämne, beskrivning och aktuella taggar.
3. Klassificera: en Text Classifier-nod sorterar texten i kategorier som du definierar, till exempel fakturering, tekniskt problem eller återbetalning. Varje kategori har ett namn och en beskrivning som hjälper modellen. Som standard tas objekt som inte matchar någon kategori bort, så aktivera grenen Other för att fånga upp dem.
4. Uppdatera: en Zendesk-nod sätter grupp och taggar. Slå först ihop de befintliga taggarna, eller lägg till taggar via noden HTTP Request med additional_tags, så att du inte raderar taggar som agenter har satt.
5. Avisera: en Slack-nod postar kategorin och en länk till ärendet i teamets kanal.
6. Hantera fel: skicka misslyckade körningar till ett larm, och vänta och försök igen när Zendesk returnerar ett 429-svar.

Du kan bygga ut samma mönster. Skicka brådskande ärenden till en separat Slack-kanal, eller slå upp kundens organisation med resursen Organization innan du väljer grupp.

Zendesk begränsar API-anrop per minut beroende på plan. Utvecklardokumentationen anger följande standardgränser för API:erna för Support och Help Center:

• Suite Team: 200 anrop per minut.
• Suite Growth och Suite Professional: 400 anrop per minut.
• Suite Enterprise: 700 anrop per minut.
• Suite Enterprise Plus: 2 500 anrop per minut.

Tillägget High Volume API höjer en kvalificerande plan till 2 500 anrop per minut. Det ersätter planens gräns i stället för att läggas till den, och kräver Suite Growth eller högre (eller Support Professional eller högre) med minst 10 agentlicenser. Över gränsen returnerar Zendesk HTTP 429 med en Retry-After-header som anger hur många sekunder du ska vänta. Vissa endpoints har egna, striktare gränser. Räkna antalet API-anrop som varje körning gör och multiplicera med din högsta ärendevolym. Massjobb, till exempel att i efterhand lägga till taggar på gamla ärenden, slår lättare i gränsen, så dela upp dem i omgångar och lägg in pauser.

n8n körs som n8n Cloud, en hanterad instans som n8n driver åt dig, eller egenhostat på din egen maskin eller infrastruktur. För de flesta egenhostade upplägg rekommenderar dokumentationen Docker, och den rekommenderar n8n Cloud om du inte är van vid att hantera servrar. Oavsett triggermetod måste Zendesk kunna nå din n8n-instans. Om en egenhostad instans ligger bakom en omvänd proxy (reverse proxy), sätt N8N_WEBHOOK_URL till dess publika bas-URL så att n8n visar rätt webhook-URL:er och externa tjänster registrerar dem korrekt. N8N_WEBHOOK_URL ersätter WEBHOOK_URL, som fortfarande fungerar men är utfasad från och med n8n 2.35.0.

TascaLab bygger Zendesk-automatiseringar som den här med n8n, Make, API:er och webhooks, ovanpå de verktyg du redan använder. Projekt med Ticket Routing & Categorization kostar 7 700 kr och projekt med Custom Automation från 11 900 kr. De flesta upplägg tar 1 till 3 veckor, och varje projekt inkluderar grundläggande dokumentation och 30 dagars support efter lansering. Du kan börja med ett kostnadsfritt Health Check-samtal på 30 minuter.