Marketing
Typeform en tu producto y en tus agentes de IA, con una API
El toolkit de Typeform cubre workspaces, formularios (listar, consultar, crear, reemplazar la definición completa), respuestas (listar, buscar por respuesta, tag, hidden field u hora) y temas. El cliente conecta con una clave de API u OAuth, Connect guarda las credenciales y registra cada ejecución, para que tu producto o agente de IA arme formularios y recoja respuestas sin una integración propia.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/typeform_create_workspace/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Typeform.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Typeform. 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 Typeform.
Generar un formulario desde un prompt
Un agente de IA convierte un brief en campos y lógica, crea el formulario con Create form y devuelve el enlace público de _links.display.
Traer respuestas a tu producto
Lee las respuestas de un formulario de la más nueva a la más antigua, o busca por un valor de respuesta o hidden field, y sincronízalas con tu CRM o panel.
Formularios plantilla por cliente
Lee un formulario con Get form, cambia lo que necesites y envía la definición completa de vuelta con Update form, conservando los ids de los campos para que las respuestas sigan asociadas.
Tools
9 tools de Typeform
- Listar workspacesGETLista los workspaces a los que accede la cuenta, entre sus organizaciones, con id, name, self.href y el número de formularios. Pagina con page hasta llegar al page_count de la respuesta.
- Crear workspacePOSTCrea un workspace en la organización en la que el usuario conectado es propietario y lo devuelve con id y self.href.
- Listar formulariosGETLista los formularios de la cuenta, públicos y privados, con id, título, fechas y el enlace público en _links.display. Pagina con page hasta llegar al page_count de la respuesta.
- Consultar formularioGETDevuelve la definición completa de un formulario: configuración, tema, workspace, hidden fields, pantallas, lógica y los campos con sus ids y refs. Los ids de los campos son lo que filtran las tools de respuestas.
- Crear formularioPOSTCrea un formulario en un workspace y lo devuelve con id, ids de los campos y el enlace público en _links.display. Las imágenes en campos y pantallas ya deben existir en la cuenta.
- Actualizar formularioPUTReemplaza la definición completa de un formulario. Léelo con Get form, cambia lo que necesites y envía todo de vuelta: cada campo conserva su id, y un campo omitido se elimina junto con sus respuestas en las respuestas existentes.
- Listar respuestasGETLista las respuestas de un formulario, de la más nueva a la más antigua, con answers, hidden fields, variables, metadatos y las horas landed_at y submitted_at. Las respuestas de los últimos 30 minutos pueden faltar. El cuerpo trae total_items; para la página siguiente, envía el response_id del último elemento como before.
- Buscar respuestasPOSTBusca las respuestas de un formulario por valores de respuesta, tags, hidden fields, metadatos u hora de envío, todas las condiciones juntas. Úsala en lugar de List responses para filtrar por una respuesta. Para la página siguiente, envía el response_id del último elemento como before_response_id.
- Listar temasGETLista los temas de la cuenta, del más nuevo al más antiguo, con id, nombre, colores y fuente. Pagina con page hasta llegar al page_count de la respuesta.
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/typeform, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Typeform
¿Necesito implementar la API de Typeform?
No. Connect ya trae 9 tools de Typeform 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 Typeform?
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
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.
