Overdrachtsconfiguratie

Met Menselijke overdracht kan je AI-agent gesprekken automatisch overdragen aan medewerkers wanneer die situaties herkent waarin persoonlijk contact nodig is. De AI stuurt de overdracht aan: de AI beoordeelt het gesprek voortdurend op basis van instelbare richtlijnen en start waar nodig een overdracht, zonder handmatig ingrijpen.

Hoe automatische overdracht werkt:

1. Tijdens een gesprek beoordeelt de AI elk bericht op basis van je algemene richtlijnen (bijvoorbeeld frustratie van de gebruiker of ontbrekende kennis) en je eigen aangepaste richtlijnen
2. Wanneer een richtlijn wordt geactiveerd, toont de AI de bezoeker een bevestigingsbericht met de vraag of die met een medewerker wil praten
3. Als de bezoeker bevestigt, wordt het gesprek overgedragen aan een medewerker, eventueel met een door AI gemaakte samenvatting van het gesprek tot dat moment
4. Als werktijden zijn ingesteld en het verzoek daarbuiten valt, verschijnt in plaats daarvan een aangepast bericht

Andere overdrachtsmethoden:

• Activering met trefwoorden: bezoekers kunnen specifieke zinnen typen (bijvoorbeeld “met een medewerker praten” of “medewerker”) om direct om overdracht te vragen
• Handmatige overdracht vanuit het dashboard: medewerkers kunnen elk gesprek in de Inbox overnemen door de toegewezen behandelaar te wijzigen

Met Routering op onderwerp kan de AI een overdracht aan één teamlid toewijzen op basis van diens routeringsbeschrijving. Elk profiel hoort bij één gebruiker en staat los van de onderwerpcategorieën in Inzichten. Stel profielen in via routing_profiles in de PUT-aanvraag. Toewijzing en ontvangers van e-mailmeldingen zijn afzonderlijke instellingen.

Optionele voorbeeldcontroles

• Bekijk een voorbeeld van een API-actieaanvraag. Vul een aangeleverd aanvraagsjabloon in met synthetische voorbeeldwaarden zonder het te versturen. Laat headers met inloggegevens weg.

• Valideer een testdataset. Controleer een kleine aangeleverde dataset op het ondersteunde formaat zonder je AI-agent uit te voeren.

Overdrachtsconfiguratie ophalen

Bereik: read_all

GET https://app.quickchat.ai/v1/api/human_handoff/configuration

Shell

curl https://app.quickchat.ai/v1/api/human_handoff/configuration \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/human_handoff/configuration",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Antwoord 200 OK

Het antwoord bevat verschillende geneste objecten:

settings: de basisconfiguratie voor overdracht:

Veld	Beschrijving
is_active boolean	Of menselijke overdracht is ingeschakeld
keywords array van strings	Trefwoorden die een overdracht activeren (bijvoorbeeld ["speak to human", "agent"])
ai_summary_active boolean	Bij overdracht een door AI gemaakte gesprekssamenvatting naar de medewerker sturen
topic_based_routing_active boolean	Of routering op onderwerp naar specifieke medewerkers is ingeschakeld (alleen lezen, ingesteld via routeringsprofielen)
question_message string	Bericht aan de bezoeker met de vraag of die met een medewerker verbonden wil worden
confirmation_message string	Bericht na bevestiging van de overdracht door de bezoeker (maximaal 500 tekens)
confirmation_outside_working_hours_message string	Bericht wanneer buiten werktijden om overdracht wordt gevraagd (maximaal 500 tekens)
working_hours_active boolean	Overdracht beperken tot werktijden
timezone string	Tijdzone voor de werktijden (bijvoorbeeld "Europe/London")
send_email_notification boolean	E-mailmeldingen naar medewerkers sturen bij overdracht
emails array van strings	E-mailadressen die meldingen ontvangen

availability: werkschema (array met tijdvakken):

Veld	Beschrijving
id integer	ID van het beschikbaarheidstijdvak
day_span string	Dag of reeks dagen (bijvoorbeeld "monday", "monday-friday")
start_time string	Begintijd in het formaat "HH:MM"
end_time string	Eindtijd in het formaat "HH:MM"

generic_guidelines: vooraf ingestelde regels voor het activeren van overdracht (array):

Veld	Beschrijving
name string	Type richtlijn: "user_frustration", "customer_support_suggestion", "lack_of_knowledge", "irrelevant_advice", "media_message"
description string	Beschrijving van wanneer deze richtlijn wordt geactiveerd
is_active boolean	Of deze richtlijn is ingeschakeld

custom_guidelines: zelf gedefinieerde regels voor het activeren van overdracht (array):

Veld	Beschrijving
id integer	ID van de richtlijn
name string	Naam van de aangepaste richtlijn (maximaal 100 tekens)
description string	Wanneer deze richtlijn overdracht moet activeren (maximaal 2.000 tekens)
is_active boolean	Of deze richtlijn is ingeschakeld

routing_profiles: routering op onderwerp stuurt overdrachten naar de juiste medewerkers op basis van het gespreksonderwerp.

Wanneer de AI een overdracht start, kan die een teamlid uit de actieve routeringsprofielen kiezen. Als de keuze geldig is, wordt het gesprek aan die gebruiker toegewezen; anders blijft het niet toegewezen. Ook andere overdrachtstriggers kunnen het gesprek niet toegewezen laten. E-mailmeldingen gebruiken settings.send_email_notification en settings.emails, onafhankelijk van de routeringskeuze.

Voorbeeld: geef een financieel teamlid de routeringsbeschrijving “Vragen over facturatie en facturen” en een technicus “Technische ondersteuning”. Bij een factuurvraag kan de AI de overdracht aan het financiële teamlid toewijzen. De ingestelde lijst met e-mailontvangers verandert niet door die toewijzing.

Stel profielen in onder Acties en MCP’s > Menselijke overdracht > Actie bewerken > Routering op onderwerp, of via de PUT-aanvraag.

Veld	Beschrijving
user_id integer	Gebruikers-ID van het teamlid; deze gebruiker moet toegang hebben tot de AI-agent
routing_description string	Gesprekken die dit teamlid moet afhandelen (maximaal 150 tekens; mag niet leeg zijn wanneer actief)
is_active boolean	Of dit routeringsprofiel is ingeschakeld
email, first_name, last_name strings	Gebruikersgegevens die GET retourneert; niet verplicht bij PUT

Overdrachtsconfiguratie bijwerken

Bereik: write_all

PUT https://app.quickchat.ai/v1/api/human_handoff/configuration

Opgepast

PUT vervangt de volledige overdrachtsconfiguratie als één atomaire bewerking. Neem settings, availability, generic_guidelines en custom_guidelines op. Neem routing_profiles op om de routering te behouden: weglaten gebruikt standaard een lege lijst en verwijdert de bestaande profielen. Voor gedeeltelijke wijzigingen haal je eerst de huidige configuratie op met GET, wijzig je de benodigde velden en stuur je het volledige object terug met PUT. Elk routeringsprofiel gebruikt user_id, routing_description en is_active.

Shell

# First, fetch the current configuration
CONFIG=$(curl -s https://app.quickchat.ai/v1/api/human_handoff/configuration \
  -H 'Authorization: Bearer <API_TOKEN>')

# Modify and PUT back (example: enable handoff)
echo "$CONFIG" | jq '.settings.is_active = true' | \
curl -X PUT https://app.quickchat.ai/v1/api/human_handoff/configuration \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d @-

Python

import requests

headers = {"Authorization": "Bearer <API_TOKEN>"}

# Fetch current configuration
config = requests.get(
    url="https://app.quickchat.ai/v1/api/human_handoff/configuration",
    headers=headers,
).json()

# Modify and PUT back
config["settings"]["is_active"] = True

response = requests.put(
    url="https://app.quickchat.ai/v1/api/human_handoff/configuration",
    headers=headers,
    json=config,
)
data = response.json()

Antwoord 200 OK: retourneert de bijgewerkte overdrachtsconfiguratie.

---