Marketing
Tally en tu producto y en tus agentes de IA, con una API
El toolkit de Tally cubre workspaces, formularios, respuestas y analíticas de formularios: listar y leer formularios con sus bloques, crearlos y actualizarlos, leer cada respuesta con sus datos y obtener visitas, finalizaciones, fuentes de tráfico y abandono por pregunta. El cliente conecta con una API key de Tally, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/tally_create_form/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"status": "BLANK",
"blocks": []
}
}Cómo funciona
Del cliente conectado a la primera llamada a Tally.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Tally. 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 Tally.
Formularios generados por tu producto
Crea un formulario de Tally a partir de una lista de bloques en el workspace del cliente y actualiza después su nombre, estado o configuración.
Respuestas en tu sistema
Lista las respuestas de un formulario y asocia cada respuesta con su pregunta por questionId, para alimentar un CRM, una base de datos o un reporte.
Rendimiento del formulario con un agente
Deja que un agente lea visitas, tasa de finalización y abandono por pregunta, y sugiera qué pregunta cambiar.
Tools
12 tools de Tally
- Listar workspacesGETLista los workspaces de la organización con id, name, miembros, invitaciones pendientes y carpetas, cada una con id y name. Pagina con page mientras hasMore sea true.
- Listar formulariosGETLista los formularios con id, name, workspaceId, status, numberOfSubmissions, isClosed y fechas. Pagina con page mientras hasMore sea true.
- Obtener formularioGETDevuelve un formulario con su configuración y todos los bloques, cada uno con uuid, type, groupUuid, groupType y payload. Actualizar formulario recibe los bloques de vuelta en este formato.
- Crear formularioPOSTCrea un formulario a partir de sus bloques y devuelve id, name, workspace y status. El formulario va al workspace predeterminado salvo que se envíe workspaceId.
- Actualizar formularioPATCHCambia el nombre, el estado, la configuración o los bloques de un formulario. Enviar blocks reemplaza todos, así que lee antes el formulario con Obtener formulario; name, status y settings pueden ir solos.
- Listar respuestas del formularioGETLista las respuestas de un formulario, cada una con id, isCompleted, submittedAt, los enlaces de vista previa y PDF y sus responses, además de las preguntas del formulario, de modo que cada respuesta se asocia con una pregunta por questionId. Pagina con page mientras hasMore sea true.
- Obtener respuesta del formularioGETDevuelve una respuesta con todos sus responses y las preguntas del formulario.
- Obtener métricas del formularioGETDevuelve los totales de un formulario en el período: visitas, vistas totales, inicios, respuestas, finalizaciones, respondientes únicos, tasa de finalización y las duraciones medias de visita y de finalización.
- Obtener visitas del formularioGETDevuelve las visitas de un formulario en el período, como conteos por intervalo.
- Obtener analíticas de respuestas del formularioGETDevuelve las respuestas completas y parciales de un formulario en el período, como conteos por intervalo.
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.
Preguntas sobre el toolkit de Tally
¿Necesito implementar la API de Tally?
No. Connect ya trae 12 tools de Tally 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 Tally?
Con el modo que acepta el toolkit: Clave de API. 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
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
