Klantprofielen en tickets
Klantprofielen opvragen en synchroniseren, en tickets aanmaken vanuit je systeem.
4.4 Klantprofiel
Gesprekken van dezelfde klant worden ondergebracht in één klantprofiel; de contact_id in het gesprek verwijst daarnaar. Identificatieregels: het lid-ID dat je ondertekent (user_token of user.id doorgegeven via de API) > kanaalgebruiker (zoals WeChat openid) > websitebezoeker. Een anonieme bezoeker wordt na inloggen samengevoegd met het profiel van het lid; twee verschillende leden worden niet automatisch samengevoegd. Als e-mailadres of telefoonnummer overeenkomt, verschijnt alleen een melding in de beheeromgeving en voegt de klantenservice ze handmatig samen.
| Methode | Pad | Beschrijving |
|---|---|---|
| GET | /v1/contacts?user_id= of ?email= | Zoek een klantprofiel op je lid-ID of e-mailadres |
| GET | /v1/contacts/{id} | Klantprofiel: naam, e-mailadres, telefoonnummer, labels tags, notities notes, aangepaste velden attributes, aantal gesprekken, tijdstip van laatste bezoek, lid-ID's user_ids |
| PATCH | /v1/contacts/{id} | Synchroniseer gegevens vanuit je systeem: name, phone, tags (maximaal 30), notes, attributes (volledig vervangen, maximaal 30 velden). Stuur alleen de velden die je wilt wijzigen |
4.5 Tickets
| Methode | Pad | Beschrijving |
|---|---|---|
| POST | /v1/tickets | Maak een ticket, bijvoorbeeld via het formulier 'Contact opnemen' op je website: subject, description, priority (urgent / high / normal / low), de name / email / phone van de klant, en optioneel een koppeling met conversation_id of contact_id. Als er een e-mailadres is, stuurt de klantenservice het antwoord per e-mail naar de klant |
| GET | /v1/tickets/{id} | Ticket en tijdlijn (klantberichten, antwoorden van de klantenservice, statuswijzigingen; exclusief interne notities) |
Ticketstatussen: open te behandelen, pending wacht op de klant, resolved opgelost, closed gesloten. De behandelingstermijn per prioriteit stel je in bij 'Botinstellingen'.
Was deze pagina nuttig?
Laatst bijgewerkt:
