API, intégration web et intégrations personnalisées

Comment lancer des sessions Blitzz à l'aide de paramètres d'URL

Simplifiez votre flux de travail en lançant des sessions vidéo Blitzz directement depuis vos systèmes d'affaires existants. Que vous utilisiez une GRC, une plateforme de billets, un système de gestion des permis ou un logiciel de service sur le terrain, cette intégration par paramètres d'URL permet à votre équipe de lancer des sessions vidéo avec les renseignements du client déjà remplis, ce qui élimine la saisie manuelle et réduit les erreurs.

Cette intégration est idéale pour :

  • Équipes de soutien à distance : lancez des appels de soutien vidéo directement depuis votre centre d'assistance ou votre système de billets
  • Service sur le terrain : mettez les techniciens en contact avec les clients pour le diagnostic et l'accompagnement à distance
  • Inspections de bâtiments et de permis : lancez des inspections virtuelles depuis votre logiciel de gestion des permis
  • Réclamations d'assurance : lancez des évaluations vidéo depuis votre plateforme de gestion des réclamations
  • Ventes et réussite client : lancez des démos de produits ou des appels d'intégration depuis votre GRC

Fonctionnement

Lorsqu'un utilisateur clique sur un bouton ou un lien (p. ex. « Start Video Session ») dans votre système, Blitzz s'ouvre dans un nouvel onglet du navigateur avec les détails de la session remplis automatiquement. L'utilisateur n'a qu'à cliquer sur « Invite and Join » pour lancer l'appel.

Avantages

  • Moins de clics : lancez des sessions vidéo sans passer d'une application à l'autre
  • Moins d'erreurs : les données du client sont remplies automatiquement à partir de votre système, sans saisie manuelle
  • Productivité accrue : gardez tout dans une seule vue pendant l'appel
  • Meilleurs rapports : liez automatiquement les sessions Blitzz aux billets, aux permis ou aux dossiers pour le suivi et l'analyse du rendement du capital investi

Exigences d'authentification

Cette intégration exige que l'hôte soit connecté à son compte Blitzz. S'il ne l'est pas, il sera invité à se connecter avant la création de la session.

Pour une expérience fluide, nous recommandons de configurer l'authentification unique (SSO) pour votre organisation. Communiquez avec notre équipe de soutien pour configurer le SSO pour votre domaine.

Structure de l'URL

Utilisez le modèle d'URL suivant pour créer des liens qui remplissent automatiquement les renseignements de la session :

https://[your-domain].blitzz.co/createsession?ref=[reference_id]&sms=[phone_number]&email=[email_address]&whatsapp=[phone_number]&callexperience=[experience_name]

Remplacez [your-domain] par votre sous-domaine Blitzz (p. ex. acme.blitzz.co).

Référence des paramètres d'URL

ParamètreDescriptionObligatoire
refVotre identifiant unique, comme un ID de billet, un numéro de permis, un numéro de dossier ou un bon de travail. L'hôte ne peut pas modifier ce champ après la création de la session.Oui
smsNuméro de téléphone du client pour l'invitation par texto. Utilisez 10 chiffres sans indicatif de pays (p. ex. 4081231234).No
emailAdresse courriel du client pour l'invitation par courriel.No
whatsappNuméro WhatsApp du client. Utilisez 10 chiffres sans indicatif de pays (p. ex. 4081231234).No
callexperiencePrésélectionne une expérience d'appel ou un modèle précis. Laissez vide pour que l'hôte choisisse au moment de l'invitation.No

Remarque : les indicatifs de pays sont propres à chaque domaine. Blitzz utilise le pays par défaut configuré pour votre domaine.

Exemples

Session de base avec ID de référence seulement :

https://acme.blitzz.co/createsession?ref=TICKET-12345

Session avec invitation par texto :

https://acme.blitzz.co/createsession?ref=TICKET-12345&sms=4081231234

Session avec invitation par courriel :

https://acme.blitzz.co/createsession?ref=TICKET-12345&email=customer@example.com

Session avec plusieurs options de contact :

https://acme.blitzz.co/createsession?ref=TICKET-12345&sms=4081231234&email=customer@example.com

Gestion des caractères spéciaux

Si votre ID de référence ou d'autres paramètres contiennent des caractères spéciaux, assurez-vous de les encoder pour l'URL. La plupart des langages de programmation offrent des fonctions intégrées à cette fin :

  • JavaScript: encodeURIComponent(value)
  • Python: urllib.parse.quote(value)
  • PHP: urlencode($value)
  • C#: Uri.EscapeDataString(value)

Exemple d'implémentation (JavaScript)

function launchBlitzzSession(referenceId, phone, email) {
  const baseUrl = "https://yourdomain.blitzz.co/createsession";
  let url = baseUrl + "?ref=" + encodeURIComponent(referenceId);
  
  if (phone) {
    url += "&sms=" + encodeURIComponent(phone);
  }
  if (email) {
    url += "&email=" + encodeURIComponent(email);
  }
  
  window.open(url, "_blank");
}

// Example usage:
launchBlitzzSession("TICKET-12345", "4081231234", "customer@example.com");

Tester votre intégration

Avant le déploiement en production, nous recommandons de tester votre intégration dans un environnement sandbox. Votre équipe peut ainsi vérifier la construction de l'URL et la création des sessions sans toucher aux données réelles.

Estimation de l'effort de mise en œuvre

Compétences requises
  • Connaissance du panneau d'administration de votre GRC ou de votre système
  • Autorisations de niveau administrateur
  • Compétences de base en programmation pour la génération dynamique d'URL
Temps de développementEnviron 10 à 20 heures (varie selon la complexité de votre système et vos exigences de gestion du changement)
Assurance qualité et tests1 à 2 heures pour les tests de base dans votre environnement
Documentation et formation
  • Mise à jour de la documentation interne avec le nouveau flux de travail
  • 15 à 30 minutes pour former les utilisateurs au nouveau processus

Besoin d'aide?

Notre équipe est là pour soutenir votre intégration. Si vous avez des questions ou besoin d'aide, veuillez soumettre un billet de soutien et nous serons heureux de vous aider!

Ressources connexes

Cette réponse a-t-elle été utile ? Oui Non

Envoyer vos commentaires
Désolés de n'avoir pu vous être utile. Aidez-nous à améliorer cet article en nous faisant part de vos commentaires.
Didn't find what you need?

Our team usually replies within one business day.

Submit a ticket