Webhooks : envoyer les événements hivi-x vers vos autres systèmes
Webhooks : envoyer les événements hivi-x vers vos autres systèmes
Réponse courte : sous Compte → Webhooks, ajoutez un point de terminaison HTTPS et choisissez des événements. hivi-x lui envoie un événement JSON signé chaque fois qu’un d’eux se produit. Tous les forfaits entreprise incluent les webhooks.
Configurer un point de terminaison
- Ouvrez Compte → Webhooks (propriétaire ou administrateur).
- Entrez l’URL, une description facultative, et cochez les événements à envoyer.
- Choisissez Ajouter et copiez le secret de signature. Il n’est affiché qu’une fois; vous pourrez le remplacer.
- Choisissez Envoyer un événement test. Un événement
webhook.testarrive, et hivi-x indique si votre point de terminaison a répondu par un code 2xx.
Jusqu’à 10 points de terminaison par espace de travail.
Événements
| Événement | Envoyé quand |
|---|---|
client.created | Un client est ajouté : à la main, par import CSV, par capture ou par conversion d’un prospect |
client.updated | Les renseignements d’un client sont modifiés |
client.deleted | Un client est supprimé (seul son identifiant est envoyé) |
checklist.item_submitted | Un client remplit un élément ou téléverse un fichier, par lien sécurisé ou par son portail |
checklist.item_reviewed | Votre équipe approuve ou renvoie une soumission |
checklist.completed | Tous les éléments applicables d’une liste sont faits |
extraction.confirmed | Quelqu’un confirme des valeurs lues avec la lecture des champs (le numéro de passeport n’est jamais envoyé) |
esign.envelope_completed | Tout le monde a signé une demande de signature |
document.expiring | Un document envoyé par un client arrive à 90, 30 ou 7 jours de sa date d’expiration, ou a expiré |
Les clients exemples et le client de répétition créés pour l’essai n’envoient pas d’événements.
Signature
Chaque requête porte l’en-tête Hivi-Signature: t=<secondes Unix>,v1=<hex>. Pour la vérifier, calculez HMAC-SHA256 avec le secret du point de terminaison sur la chaîne "<t>.<corps brut>" et comparez le résultat à v1 en temps constant. Refusez la requête si t date de plus de cinq minutes. Exemples en Node.js et Python : Verify webhook signatures.
Envois, nouvelles tentatives et désactivation
- Répondez par un code 2xx en moins de 10 secondes. Toute autre réponse, une redirection ou un délai dépassé est un échec.
- Un envoi échoué est relancé après 1 minute, 5 minutes, 30 minutes, 2 heures, 6 heures, 12 heures et 24 heures : 8 tentatives sur environ deux jours.
- Si 5 événements de suite échouent à chaque tentative, le point de terminaison est désactivé et le propriétaire reçoit un courriel. Le réactiver remet le compte à zéro.
- L’historique des envois garde chaque envoi 30 jours, avec son statut, son code HTTP, l’erreur et le corps JSON exact. Renvoyer l’envoie de nouveau, une fois.
- Un événement peut arriver plus d’une fois et dans le désordre. Utilisez son
idpour ignorer les doublons. - Tant que le compte est bloqué (essai terminé, paiement en souffrance ou abonnement terminé), rien n’est envoyé.
Règles de sécurité
- HTTPS seulement, vers des adresses publiques. Les adresses privées, locales, de liaison locale et de métadonnées infonuagiques sont refusées, et l’adresse est revérifiée avant chaque envoi. Les redirections ne sont pas suivies.
- Aucun fichier n’est envoyé, seulement les noms et tailles. Les valeurs non confirmées de la lecture des champs ne sont jamais envoyées.
- Supprimer un client supprime aussi les corps d’envoi conservés à son sujet, sauf l’événement de suppression.
Le point de terminaison et ce vers quoi il transmet vous appartiennent : hivi-x y envoie des données clients parce que vous l’avez configuré. Choisissez des destinataires à qui vous confieriez ces données.
Limites
- Les webhooks sont sortants seulement. Pour agir dans hivi-x depuis Zapier (créer des clients, envoyer des listes), utilisez l’application hivi-x pour Zapier. Il n’y a pas d’application dans le répertoire Make.
- Vous choisissez les types d’événements, pas les champs. Un événement contient toujours les mêmes champs : un événement client inclut toujours le nom, le courriel et le téléphone. Il n’y a pas d’option « identifiants seulement ».
- Un seul secret de signature par point de terminaison; le remplacer prend effet tout de suite.
Voir aussi
Les réponses sont des renseignements opérationnels généraux seulement — pas un avis juridique, fiscal, réglementaire, clinique, relatif à la vie privée, à l’immigration ou professionnel. Les exigences varient selon le dossier, le client et l’organisme de réglementation.
Questions fréquentes
- hivi-x a-t-il des webhooks?
- Oui, dans tous les forfaits entreprise. Sous Compte → Webhooks, ajoutez un point de terminaison HTTPS, choisissez ses événements et copiez son secret de signature. hivi-x lui envoie ensuite un événement JSON chaque fois qu’un de ces événements se produit.
- hivi-x fonctionne-t-il avec Zapier ou Make?
- Oui, par les webhooks. Utilisez Webhooks by Zapier (Catch Hook) ou le Custom webhook de Make comme déclencheur, collez son URL dans hivi-x et envoyez un événement test. hivi-x n’a pas d’application dans les répertoires Zapier ou Make, ni d’API entrante.
- Les fichiers téléversés sont-ils envoyés?
- Non. Les événements liés aux téléversements donnent le nom, le type et la taille du fichier, jamais le fichier ni un lien de téléchargement.
- Que se passe-t-il si mon point de terminaison est en panne?
- hivi-x relance un envoi échoué jusqu’à 8 fois sur environ deux jours. Si cinq événements de suite échouent à chaque tentative, il désactive le point de terminaison et écrit au propriétaire du compte. Chaque envoi reste 30 jours dans l’historique, où vous pouvez le renvoyer.
- Qui peut configurer les webhooks?
- Le propriétaire et les administrateurs de l’espace de travail. Le personnel ne peut ni les voir ni les modifier.
Organisez la collecte de documents clients avec des listes
hivi-x aide les professionnels de l’Ontario à recueillir les documents clients avec des listes réutilisables, un hébergement sécurisé au Canada et des trousses PDF exportables.
Autres guides — Features
- Vérifications automatiques des documentsLes nouveaux téléversements par lien invité ou depuis un compte affichent des avertissements sans bloquer l’envoi. Les photos utilisent une IA auto-hébergée; les vérifications PDF sont limitées.
- Recueillir des documents auprès de clients qui lisent peu l’anglaisUtilisez la langue du portail, des instructions claires et des éléments distincts pour les originaux et les traductions nécessaires.
- Alertes d’expiration et de renouvellement des documents clientshivi-x suit la date d’expiration des passeports, permis, licences et polices envoyés par vos clients, vous écrit 90, 30 et 7 jours avant, et demande au client une copie renouvelée en un clic.
- Détection des documents en doubleLes nouveaux téléversements par lien invité ou depuis un compte sont comparés aux envois récents de ce client pour repérer les copies exactes. Un avertissement ne bloque jamais le téléversement.
- Un portail client en huit languesLes clients peuvent utiliser le portail en anglais, français, espagnol, portugais, ukrainien, chinois, hindi ou bengali. Les instructions de l’entreprise restent telles qu’elles ont été écrites.
- Éviter de recevoir deux fois le même documentDes éléments précis, un nombre de fichiers demandé et des avertissements de doublon aident les clients à envoyer les bons documents.
- Collègue ou co-agent : lequel choisirUn collègue travaille dans votre cabinet, occupe un poste payé et utilise votre espace de travail. Un co-agent vient d’un autre cabinet, se joint gratuitement à un seul client et ne voit que ce que vous partagez.
- Espaces de travail d’équipe et rôlesInvitez vos collègues dans un seul espace de travail hivi-x qui partage vos clients, listes, modèles et demandes de signature. Chaque poste coûte le prix du forfait; les rôles propriétaire, administrateur et personnel décident qui peut faire quoi.
- hivi-x pour Zapier : déclencheurs, actions et configurationConnectez hivi-x à Zapier : envoyez une liste de documents quand une transaction avance dans votre CRM, ajoutez des clients depuis vos formulaires et prévenez Slack quand une liste est complète. Tous les forfaits d’entreprise.