Marketing
Dub dans votre produit et vos agents IA, via une API
Le toolkit Dub liste, crée et met à jour des liens courts, les organise avec tags et dossiers, et lit les analytics ainsi que les événements de clic, lead et vente un par un. Votre produit ou agent IA les appelle via Connect, qui gère la connexion OAuth du client et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/dub_create_link/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"url": "<url>"
}
}Fonctionnement
Du client connecté au premier appel à Dub.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Dub. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Dub.
Liens courts dans votre produit
Un SaaS crée un lien court avec paramètres UTM pour chaque campagne ou invitation et conserve le shortLink renvoyé.
Rapports de campagne par clics
Un outil d'agence récupère clics, leads et ventes par lien, tag ou dossier et les affiche dans son propre tableau de bord.
Agent qui range les liens
Un agent IA liste les liens, crée un tag pour un client et met à jour ou archive les liens obsolètes.
Tools
10 tools Dub
- Lister les liensGETListe les liens courts du workspace avec destination, tags, dossier, paramètres UTM et les nombres de clics, leads et ventes. Pour la page suivante, envoyez l'id du dernier lien.
- Obtenir un lienGETRenvoie un lien court avec les nombres de clics, leads et ventes. Envoyez domain et key ensemble, comme dub.sh et abc123 pour dub.sh/abc123, ou envoyez linkId.
- Créer un lienPOSTRaccourcit une URL et renvoie le lien court dans shortLink, avec son id. Sans domain il utilise le domaine principal du workspace, ou dub.sh s'il n'y en a pas.
- Mettre à jour un lienPATCHModifie un lien court ; seuls les champs envoyés changent. Un nouveau domain ou key change le lien court lui-même, et archived à true masque le lien de Lister les liens.
- Obtenir les analyticsGETRenvoie clics, leads ou ventes du workspace, d'un domaine, lien, tag ou dossier, en total, série temporelle ou classement choisi par groupBy.
- Lister les événementsGETListe les événements de clic, lead ou vente un par un, avec l'heure, le lien et les détails du clic et, pour les leads et ventes, le client. Exige le plan Business ou supérieur.
- Lister les domainesGETListe les domaines personnalisés du workspace, dont le slug va dans l'argument domain des tools de lien. Les pages commencent à 1, et une page plus courte que pageSize est la dernière.
- Lister les tagsGETListe les tags du workspace avec leurs ids et couleurs. Les pages commencent à 1, et une page plus courte que pageSize est la dernière.
- Créer un tagPOSTCrée un tag pour organiser les liens, comme une campagne ou un client. La réponse contient l'id qui va dans tagIds.
- Lister les dossiersGETListe les dossiers de liens du workspace avec leurs ids. Les pages commencent à 1, et une page plus courte que pageSize est la dernière.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/dub, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Dub
Dois-je intégrer l'API Dub moi-même ?
Non. Connect fournit 10 tools Dub décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Dub ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
