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.