Marketing
Bitly en tu producto y en tus agentes de IA, con una API
El toolkit de Bitly cubre los grupos, Bitlinks y métricas de clics de una cuenta Bitly: crear y actualizar enlaces, y leer clics por período, país, referente y dispositivo. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/bitly_create_bitlink/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"long_url": "<long_url>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Bitly.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Bitly. 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 Bitly.
Acortar enlaces en tu producto
Cuando tu SaaS envía una campaña o notificación, crea un Bitlink para cada URL larga en el grupo del cliente y guarda el enlace corto.
Informes de clics para clientes
Una herramienta de agencia obtiene clics por día, país y referente de cada Bitlink y los muestra en un informe del cliente.
Redirigir sin crear enlaces nuevos
Actualiza la long_url de un Bitlink existente para redirigir un enlace corto ya impreso o compartido, y deja que un agente de IA revise los clics después.
Tools
11 tools de Bitly
- Listar gruposGETLista los grupos a los que pertenece la cuenta. Cada grupo tiene el guid que las otras tools piden como group_guid y, en bsds, los dominios personalizados con los que el grupo puede acortar enlaces.
- Listar BitlinksGETLista los Bitlinks de un grupo, con id, link, long_url, título y etiquetas. La respuesta tiene links y pagination: pasa pagination.search_after como search_after, con los mismos filtros, para leer la página siguiente.
- Obtener BitlinkGETDevuelve un Bitlink: el enlace corto, long_url, título, etiquetas, archived, created_at y los back-halves personalizados que tuvo.
- Crear BitlinkPOSTAcorta una URL larga en un nuevo Bitlink y lo devuelve, con el enlace corto en link y el id en id. Cuenta para el límite mensual de enlaces del plan, y las funciones que el plan no tiene, como un back-half personalizado, responden 402 UPGRADE_REQUIRED.
- Actualizar BitlinkPATCHActualiza un Bitlink y lo devuelve. Los campos omitidos conservan su valor. Cambiar long_url redirige el enlace y siempre cuenta para el límite mensual de enlaces del plan; los planes sin redirecciones responden 402 UPGRADE_REQUIRED.
- Obtener clics del BitlinkGETDevuelve los clics de un Bitlink por unidad de tiempo, en link_clicks con date y clicks. unit y units definen la ventana: unit day con units 30 son los 30 días hasta unit_reference.
- Obtener resumen de clics del BitlinkGETDevuelve el total de clics de un Bitlink en una ventana, en total_clicks. unit y units definen la ventana: unit day con units 30 son los 30 días hasta unit_reference.
- Obtener clics del Bitlink por paísGETDevuelve los clics de un Bitlink por país en una ventana, en metrics con value (el código del país) y clicks. unit y units definen la ventana: unit day con units 30 son los 30 días hasta unit_reference.
- Obtener clics del Bitlink por referenteGETDevuelve los clics de un Bitlink por referente en una ventana, en metrics con value (el referente) y clicks. unit y units definen la ventana: unit day con units 30 son los 30 días hasta unit_reference.
- Obtener clics del Bitlink por dispositivoGETDevuelve los clics de un Bitlink por tipo de dispositivo en una ventana. unit y units definen la ventana: unit day con units 30 son los 30 días hasta unit_reference. Los planes sin este informe responden 402 UPGRADE_REQUIRED.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/bitly, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Bitly
¿Necesito implementar la API de Bitly?
No. Connect ya trae 11 tools de Bitly 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 Bitly?
Con el modo que acepta el toolkit: Clave de API, 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.
Toolkits de la misma categoría
Canva12 tools
Dub10 tools
Google Tag Manager13 tools
Jotform8 tools
Manychat14 tools
SurveyMonkey11 tools
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
