Ouvrir un ticket de support
Déposez un ticket sur le guichet de votre forfait depuis du code externe, et interrogez-le jusqu'à ce que quelqu'un réponde.
ticket_api_submit ouvre un ticket sur le guichet que possède le forfait de votre clé API, le même guichet que gère
l'écran Ticketing du tableau de bord. ticket_api_get en relit un, réponses publiques comprises : tout ce qu'il faut
pour construire un formulaire « contactez-nous » adossé à un vrai guichet plutôt qu'à une boîte mail.
Méthodes
API: Submit Ticket
External service: opens a ticket on the desk owned by the API key. Requires a plan with full API access.
API: Get Ticket
External service: one ticket with its public interactions. Internal notes are never returned.
Pas à pas
Soumettre le ticket
name, email et details sont obligatoires. L'e-mail sert aussi de clé de recherche dans le carnet de contacts :
renvoyer depuis la même adresse se rattache au même contact, comme le fait
ajouter un contact.
2. L'interroger pour une réponse
Conservez data.id de l'appel d'envoi et relisez-le avec ticket_api_get chaque fois que vous voulez vérifier s'il
y a du mouvement ; interactions ne porte que le fil public, les notes internes du guichet sont filtrées avant que
cette méthode ne réponde.
La réponse
Les deux méthodes répondent avec la même vue de ticket étroite et sûre pour l'extérieur, sans identifiant de propriétaire ni état interne :
ticket_api_get ajoute une clé de plus, interactions, un tableau de { direction, from, channel, body, ts } dans l'ordre du fil, vide tant que quelqu'un du guichet (ou le demandeur, par un autre canal) n'a pas répondu.