Marketing
Dub en tu producto y en tus agentes de IA, con una API
El toolkit de Dub lista, crea y actualiza enlaces cortos, los organiza con etiquetas y carpetas, y lee analíticas y eventos individuales de clic, lead y venta. Tu producto o agente de IA los llama por Connect, que maneja la conexión OAuth del cliente y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
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>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Dub.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Dub. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Dub.
Enlaces cortos en tu producto
Un SaaS crea un enlace corto con parámetros UTM para cada campaña o invitación y guarda el shortLink devuelto.
Informes de campaña con clics
Una herramienta de agencia obtiene clics, leads y ventas por enlace, etiqueta o carpeta y los muestra en su propio panel.
Agente que ordena enlaces
Un agente de IA lista enlaces, crea una etiqueta para un cliente y actualiza o archiva enlaces desactualizados.
Tools
10 tools de Dub
- Listar enlacesGETLista los enlaces cortos del workspace con destino, etiquetas, carpeta, parámetros UTM y los conteos de clics, leads y ventas. Para la página siguiente, envía el id del último enlace.
- Obtener enlaceGETDevuelve un enlace corto con los conteos de clics, leads y ventas. Envía domain y key juntos, como dub.sh y abc123 para dub.sh/abc123, o envía linkId.
- Crear enlacePOSTAcorta una URL y devuelve el enlace corto en shortLink, con su id. Sin domain usa el dominio principal del workspace, o dub.sh si no hay.
- Actualizar enlacePATCHCambia un enlace corto; solo cambian los campos enviados. Un nuevo domain o key cambia el propio enlace corto, y archived en true oculta el enlace de Listar enlaces.
- Obtener analíticasGETDevuelve clics, leads o ventas del workspace, de un dominio, enlace, etiqueta o carpeta, como total, serie temporal o ranking elegido por groupBy.
- Listar eventosGETLista eventos de clic, lead o venta uno por uno, con hora, enlace y detalles del clic y, para leads y ventas, el cliente. Exige el plan Business o superior.
- Listar dominiosGETLista los dominios personalizados del workspace, cuyo slug va en el argumento domain de las tools de enlace. Las páginas empiezan en 1, y una página menor que pageSize es la última.
- Listar etiquetasGETLista las etiquetas del workspace con sus ids y colores. Las páginas empiezan en 1, y una página menor que pageSize es la última.
- Crear etiquetaPOSTCrea una etiqueta para organizar enlaces, como una campaña o un cliente. La respuesta trae el id que va en tagIds.
- Listar carpetasGETLista las carpetas de enlaces del workspace con sus ids. Las páginas empiezan en 1, y una página menor que pageSize es la última.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/dub, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Dub
¿Necesito implementar la API de Dub?
No. Connect ya trae 10 tools de Dub descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Dub?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
