Saltar al contenido principal

Typeform

¿Prefieres configuracion guiada con IA?

En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.

Descripción General​

Conecta tu cuenta de Typeform a Nirvai para automatizar la gestión de formularios, acceder a respuestas e integrar datos de encuestas en tus flujos de trabajo.

Métodos de Autenticación Soportados​

  • Personal Access Token - Recomendado para acceso a la API

Requisitos Previos​

  • Una cuenta de Typeform
  • Acceso a la configuración de desarrollador de Typeform

Instrucciones de Configuración​

Personal Access Token​

  1. Inicia sesión en tu cuenta de Typeform
  2. Haz clic en tu avatar en la esquina superior derecha
  3. Selecciona Your settings
  4. Navega a Personal tokens (bajo la sección Developer)
  5. Haz clic en Generate a new token
  6. Ingresa un nombre para el token (ej., "Integración Nirvai")
  7. Selecciona los scopes requeridos:
    • Forms: Read (para acceder a datos de formularios)
    • Responses: Read (para acceder a respuestas de formularios)
    • Webhooks: Read, Write (para notificaciones en tiempo real)
  8. Haz clic en Generate token
  9. Copia el token inmediatamente (no se mostrará de nuevo)
  10. Pega el token en Nirvai

Scopes Requeridos​

ScopeNivel de AccesoRequerido Para
FormsReadAcceder a estructura y metadatos de formularios
ResponsesReadObtener envíos de formularios
WebhooksRead, WriteConfigurar notificaciones de respuestas en tiempo real
WorkspacesReadAcceder a información de espacios de trabajo
ImagesRead, WriteGestionar imágenes de formularios
ThemesReadAcceder a temas de formularios

Operaciones Disponibles​

Con credenciales de Typeform, puedes:

  • Listar y obtener formularios
  • Acceder a respuestas de formularios
  • Crear y gestionar webhooks
  • Obtener estadísticas de respuestas
  • Descargar datos de respuestas
  • Gestionar espacios de trabajo de formularios

Solución de Problemas​

Problemas Comunes​

  • 401 Unauthorized: El token es inválido o expiró. Genera un nuevo token.
  • 403 Forbidden: El token carece de scopes requeridos. Crea un nuevo token con permisos apropiados.
  • Formulario no encontrado: Asegúrate de que el ID del formulario sea correcto y el token tenga acceso.
  • Rate Limiting: Typeform tiene límites de API. Implementa lógica de reintento si es necesario.

Gestión de Tokens​

  • Los tokens no expiran automáticamente
  • Puedes revocar tokens en cualquier momento en la configuración
  • Cada token puede tener diferentes combinaciones de scopes
  • Mantén los tokens seguros - proporcionan acceso a la API

Encontrar IDs de Formularios​

Para encontrar un ID de formulario:

  1. Abre el formulario en Typeform
  2. Mira la URL: https://admin.typeform.com/form/{form_id}/...
  3. El ID del formulario es la cadena después de /form/

Recursos Relacionados​


Adaptado de la documentación de n8n para la plataforma Nirvai


Siguientes Pasos​

¿Ya tienes tu credencial? Conectala a un agente

Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.