Skapa ärenden från era egna system
Har ni ett eget formulär, en app eller ett system som ska skapa supportärenden — skicka dem till webhook-ändpunkten.
curl -X POST https://din-arbetsyta.supportifier.app/api/webhook/ticket \
-H "x-api-key: DIN_NYCKEL" \
-H "content-type: application/json" \
-d '{
"email": "kund@example.com",
"name": "Anna Andersson",
"subject": "Frågor om min beställning",
"message": "Hej, jag undrar…",
"priority": "medium"
}'
Svaret innehåller ticketId och merged — det senare är sant när mailet
matchade ett pågående ärende (ämnesrad som börjar med Re:/Sv:) och lades
i det i stället för att skapa ett nytt.
Ärendet blir ett riktigt ärende
Det som skapas via API:t behandlas som allt annat: kundkontext hämtas från integrationerna, ärendet klassas, ett AI-utkast skrivs och kundens svar på ert svar landar i samma ärende. Ett återöppnat ärende får status Öppna.
Använd rätt e-postadress
email är nyckeln till allt: kundhistoriken, integrationsuppslagen och
tråden framåt. Skicka kundens riktiga adress — inte en systemadress och
inte en no-reply.
Vanliga användningar
- Eget kontaktformulär som ni inte vill byta ut.
- In-app-support — en "rapportera problem"-knapp i er produkt, gärna med teknisk kontext i meddelandet.
- Automatiska larm som en människa ska titta på: misslyckade betalningar, leveranser som fastnat.
Praktiska råd
- Lägg ordernummer och versionsnummer i meddelandetexten. Det AI:n ser kan den använda.
- Skapa inte dubbletter. Har ni redan ett retry-lager, se till att det inte skickar samma händelse två gånger.
- Skapa inte ärenden av allt. Ett larm som ingen ska agera på hör hemma i ett övervakningsverktyg, inte i supportkön — och det räknas i förbrukningen.
Begränsningar
Ändpunkten kräver en giltig API-nyckel och är begränsad
till 30 anrop per minut och anropare. Ska ni massimportera historik — hör av
er först, det finns bättre vägar än en webhook per ärende. POST /api/tickets
i det vanliga API:t gör samma sak med fältnamnen customerEmail,
customerName, subject och originalMessage.