Fonctionnalités
Vos données, dans vos propres outils
Lisez et écrivez ce que contient Hivenza depuis votre code avec une API REST, soyez prévenu des événements par webhooks, envoyez des données de reporting vers Looker Studio ou votre propre bucket, et laissez un assistant IA travailler avec vos marques.
CommencerAPI, webhooks et exports avec Pro et Agency. Le connecteur d’assistants IA dès Starter.
Quatre façons d’entrer
- 1
Créez une clé
Choisissez ses portées et ses marques, une liste d’adresses IP autorisées et une date d’expiration. Elle ne s’affiche qu’une fois, et vous pouvez la renouveler.
- 2
Appelez l’API
REST sous /v1 : publications, médias, boîte de réception, tickets, contacts, statistiques, veille et workflows.
- 3
Écoutez avec les webhooks
Des événements signés pour les messages, conversations, tickets, publications, mentions, exécutions de workflows et plus.
- 4
Exportez pour vos rapports
Des jeux de données en CSV ou Parquet, tout de suite ou selon un calendrier, ou lus en direct dans Looker Studio.
Ce que vous obtenez
L’API sert au code que votre équipe écrit. Les données de reporting sont en lecture seule.
- Clés à portées
- Des portées comme posts:read ou tickets:write, limitées à certaines marques, avec une liste d’adresses IP autorisées et une expiration. La publication a sa propre portée : une clé peut écrire des brouillons sans rien envoyer.
- Mode test
- Une clé de test n’agit que sur une marque de test, où rien n’atteint un réseau, une boîte de réception ou une carte.
- Pensée pour les reprises
- Pagination par curseur, clés d’idempotence, un identifiant de requête sur chaque appel et un seul format d’erreur.
- Limites selon l’offre
- Pro permet 5 clés, 120 appels par minute et 50 000 par jour. Agency permet 25 clés, 600 par minute et 500 000 par jour.
- Webhooks
- Signés avec un horodatage et gardés dans un journal d’événements de 30 jours. Zapier, Make et n8n peuvent aussi les écouter.
- Jeux de données de reporting
- Conversations, tickets, événements de tickets, avis, publications, indicateurs des comptes et usage, filtrés par date et par marque, avec un dictionnaire des champs. Les clients n’apparaissent que par identifiant.
- Exports programmés
- CSV ou Parquet, chaque jour, semaine ou mois, vers un lien signé ou vers votre propre bucket Google Cloud Storage.
- Looker Studio
- Un connecteur communautaire lit les mêmes jeux de données. Power BI et Tableau peuvent lire les fichiers de votre bucket.
- Assistants IA
- Un connecteur permet à Claude et à ChatGPT de travailler avec vos marques en tant que la personne qui les a connectés, avec son rôle. Il existe un choix « lecture seule ».
Avec Pro et Agency
L’API, les webhooks et les exports BI viennent avec Pro et Agency, et Enterprise a des limites plus hautes. Le connecteur d’assistants IA commence dès Starter.
Questions
Qui peut voir les exports ?
Les propriétaires et les administrateurs les configurent. Un lien de téléchargement dure 10 minutes, chaque téléchargement est journalisé et le fichier est supprimé après 7 jours.
Puis-je essayer l’API sans risque ?
Oui. Une clé de test n’agit que sur une marque de test, et la publication y est simulée.
Un assistant peut-il publier à ma place ?
Il agit comme vous, avec votre rôle, et les publications qui demandent une validation la demandent toujours. Vous pouvez rendre la connexion en lecture seule.
Y a-t-il une API pour les workflows ?
Oui. Les clés avec les portées workflows peuvent lister, créer, publier, mettre en pause et lancer des workflows, et les webhooks signalent les exécutions.
Comment obtenir une clé ?
Un propriétaire ou un administrateur crée les clés dans les réglages de l’espace, avec Pro et Agency. Chaque clé montre ses portées, ses marques, son expiration et son usage.
Reliez Hivenza aux outils que vous utilisez déjà
