API-referentie: Hooks-endpoints

• GET /api/HookActions – Bearer JWT
  Toont hook-actie koppelingen. Minstens één filter is vereist: hookName of actionId. Query ondersteunt ook pageNumber, pageSize, sortBy en sortOrder. pageNumber wordt minstens op 1 gezet; pageSize is begrensd tot 1-100.
• POST /api/HookActions – Bearer JWT
  Maak één hook-actie koppeling aan vanuit HookActionCreateDTO. De server stelt het klantbereik in en slaat hookName op als het speciale topic van de hook. Dubbele combinaties geven 409 Conflict terug.
• POST /api/HookActions/bulk – Bearer JWT
  Maak meerdere hook-actie koppelingen aan. Bestaande combinaties worden overgeslagen door de service; databasefouten geven 500.
• GET /api/HookActions/{id} – Bearer JWT
  Ophalen van een eigen hook-actie koppeling. Records zonder een hook special topic, of specialTopic=All, worden niet als HookActions beschouwd.
• PUT /api/HookActions/{id} – Bearer JWT
  Pas enkel de prioriteit van een bestaande eigen hook-actie koppeling aan.
• DELETE /api/HookActions/{id} – Bearer JWT
  Verwijder een eigen hook-actie koppeling.
• GET /api/HookActions/wait-seconds – Bearer JWT
  Geeft de totale wachttijd terug voor actieve Wait-acties die overeenkomen met channelId en hookName. Query: channelId en hookName.

• GET /api/HookDocuments/promptDocuments – TicketAccessOrPhoneAuth
  Geeft PromptDocumentDTO records terug voor een hookName en optionele channelId. Telefoon-authenticatie aanvragen zijn beperkt tot het tokenkanaal. Speciale placeholders in documentinhoud worden vervangen voor terugkeer.
• POST /api/HookDocuments – Bearer JWT
  Maak een hook-document koppeling aan met TopicDocumentCreateDTO. Voor hooks moet topicID null zijn en specialTopic de hook naam. Dubbele koppelingen geven 409 Conflict terug.

• GET /api/TicketMessages/{id}/promptDocuments – TicketAccessOrPhoneAuth
  Geeft promptdocumenten voor een bericht. Optionele query hookName selecteert hook-documenten; topicId selecteert topic-documenten; onlyPromptDocuments slaat historische ticket- of eindgebruikersdata over.
• POST /api/TicketMessages/{id}/execute-hook – TicketAccessOrPhoneAuth
  Voert alle geconfigureerde acties uit voor query hookName op het ticketbericht. Telefoon-authenticatie aanvragen moeten overeenkomen met het berichtkanaal.
• GET /api/TicketMessages/{id}/execute-single-action – TicketAccess
  Voer één actietype handmatig uit voor een bericht. Query: action en optionele stage, standaard naar UserTriggered.

Huidige HookName enumwaarden:

• PreSpam, PostSpam, PostTopicDetection
• OnEscalate, PostEscalate, OnEscalateFailed
• OnClose, UserTriggered
• OnEndUserAdd, OnEndUserUpdate, OnEndUserDelete
• OnPhonePickup, OnPhonePickupSay

• Inkomende authenticatie
  Beveiligde AnswerPal API-endpoints gebruiken JWT Bearer-authenticatie. Voor het aanmaken van HookActions en HookDocuments is een geauthenticeerde klantcontext vereist.
• Telefoon-authenticatie hook-toegang
  GET /api/HookDocuments/promptDocuments, GET /api/TicketMessages/{id}/promptDocuments en POST /api/TicketMessages/{id}/execute-hook ondersteunen telefoon-authenticatie context waar geconfigureerd. Telefoon-auth-calls worden met 403 afgewezen wanneer het gevraagde of berichtkanaal afwijkt van het tokenkanaal.
• 400 Bad Request
  GET /api/HookActions vereist hookName of actionId. Ticket-bericht-promptdocumenten kunnen ook 400 opleveren als historische data wordt opgevraagd zonder dat er een OpenAI API-sleutel voor de klant aanwezig is.
• 404 Not Found
  Hook-actie, hook-document, ticketbericht of klant werd niet gevonden binnen de geauthenticeerde scope.
• 409 Conflict
  Dubbele hook-actie of hook-document combinaties.
• 500 Server Error
  Onverwachte databasefouten tijdens bulk hook-actie aanmaak of hook-document aanmaak.