---
title: Typeform
description: Interactúa con Typeform
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="typeform"
  color="#262627"
/>

{/* MANUAL-CONTENT-START:intro */}
[Typeform](https://www.typeform.com/) es una plataforma fácil de usar para crear formularios conversacionales, encuestas y cuestionarios con un enfoque en la experiencia atractiva del usuario.

Con Typeform, puedes:

- **Crear formularios interactivos**: Diseña formularios conversacionales atractivos que involucran a los encuestados con una interfaz única de una pregunta a la vez
- **Personalizar tu experiencia**: Utiliza lógica condicional, campos ocultos y temas personalizados para crear recorridos de usuario personalizados
- **Integrar con otras herramientas**: Conéctate con más de 1000 aplicaciones a través de integraciones nativas y APIs
- **Analizar datos de respuestas**: Obtén información procesable a través de herramientas completas de análisis e informes

En Sim, la integración de Typeform permite a tus agentes interactuar programáticamente con tus datos de Typeform como parte de sus flujos de trabajo. Los agentes pueden recuperar respuestas de formularios, procesar datos de envío e incorporar comentarios de usuarios directamente en los procesos de toma de decisiones. Esta integración es particularmente valiosa para escenarios como la calificación de leads, análisis de comentarios de clientes y personalización basada en datos. Al conectar Sim con Typeform, puedes crear flujos de trabajo de automatización inteligentes que transforman las respuestas de formularios en información procesable - analizando sentimientos, categorizando comentarios, generando resúmenes e incluso desencadenando acciones de seguimiento basadas en patrones específicos de respuesta.
{/* MANUAL-CONTENT-END */}

## Instrucciones de uso

Integra Typeform en el flujo de trabajo. Puede recuperar respuestas, descargar archivos y obtener información de formularios. Se puede usar en modo de activación para iniciar un flujo de trabajo cuando se envía un formulario. Requiere clave API.

## Herramientas

### `typeform_responses`

Recuperar respuestas de formularios de Typeform

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `formId` | string | Sí | ID del formulario de Typeform |
| `apiKey` | string | Sí | Token de acceso personal de Typeform |
| `pageSize` | number | No | Número de respuestas a recuperar \(predeterminado: 25\) |
| `since` | string | No | Recuperar respuestas enviadas después de esta fecha \(formato ISO 8601\) |
| `until` | string | No | Recuperar respuestas enviadas antes de esta fecha \(formato ISO 8601\) |
| `completed` | string | No | Filtrar por estado de finalización \(true/false\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `total_items` | number | Número total de respuestas |
| `page_count` | number | Número total de páginas disponibles |
| `items` | array | Array de objetos de respuesta con response_id, submitted_at, answers y metadata |

### `typeform_files`

Descargar archivos subidos en respuestas de Typeform

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `formId` | string | Sí | ID del formulario de Typeform |
| `responseId` | string | Sí | ID de respuesta que contiene los archivos |
| `fieldId` | string | Sí | ID único del campo de carga de archivos |
| `filename` | string | Sí | Nombre del archivo subido |
| `inline` | boolean | No | Si se debe solicitar el archivo con Content-Disposition en línea |
| `apiKey` | string | Sí | Token de acceso personal de Typeform |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `fileUrl` | string | URL de descarga directa para el archivo subido |
| `contentType` | string | Tipo MIME del archivo subido |
| `filename` | string | Nombre original del archivo subido |

### `typeform_insights`

Obtener información y análisis para formularios de Typeform

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `formId` | string | Sí | ID del formulario de Typeform |
| `apiKey` | string | Sí | Token de acceso personal de Typeform |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `fields` | array | Número de usuarios que abandonaron en este campo |

### `typeform_list_forms`

Recupera una lista de todos los formularios en tu cuenta de Typeform

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de acceso personal de Typeform |
| `search` | string | No | Consulta de búsqueda para filtrar formularios por título |
| `page` | number | No | Número de página \(predeterminado: 1\) |
| `pageSize` | number | No | Número de formularios por página \(predeterminado: 10, máx: 200\) |
| `workspaceId` | string | No | Filtrar formularios por ID de espacio de trabajo |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `total_items` | number | Número total de formularios en la cuenta |
| `page_count` | number | Número total de páginas disponibles |
| `items` | array | Array de objetos de formulario con id, title, created_at, last_updated_at, settings, theme y _links |

### `typeform_get_form`

Recuperar detalles completos y estructura de un formulario específico

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de acceso personal de Typeform |
| `formId` | string | Sí | Identificador único del formulario |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `id` | string | Identificador único del formulario |
| `title` | string | Título del formulario |
| `type` | string | Tipo de formulario \(form, quiz, etc.\) |
| `settings` | object | Configuración del formulario incluyendo idioma, barra de progreso, etc. |
| `theme` | object | Referencia del tema |
| `workspace` | object | Referencia del espacio de trabajo |
| `fields` | array | Array de campos/preguntas del formulario |
| `welcome_screens` | array | Array de pantallas de bienvenida \(vacío si no hay ninguna configurada\) |
| `thankyou_screens` | array | Array de pantallas de agradecimiento |
| `created_at` | string | Marca de tiempo de creación del formulario \(formato ISO 8601\) |
| `last_updated_at` | string | Marca de tiempo de última actualización del formulario \(formato ISO 8601\) |
| `published_at` | string | Marca de tiempo de publicación del formulario \(formato ISO 8601\) |
| `_links` | object | Enlaces de recursos relacionados incluyendo URL pública del formulario |

### `typeform_create_form`

Crear un nuevo formulario con campos y configuraciones

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de acceso personal de Typeform |
| `title` | string | Sí | Título del formulario |
| `type` | string | No | Tipo de formulario \(predeterminado: "form"\). Opciones: "form", "quiz" |
| `workspaceId` | string | No | ID del espacio de trabajo donde crear el formulario |
| `fields` | json | No | Array de objetos de campo que definen la estructura del formulario. Cada campo necesita: tipo, título y propiedades/validaciones opcionales |
| `settings` | json | No | Objeto de configuración del formulario \(idioma, barra_de_progreso, etc.\) |
| `themeId` | string | No | ID del tema a aplicar al formulario |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `id` | string | Identificador único del formulario creado |
| `title` | string | Título del formulario |
| `type` | string | Tipo de formulario |
| `settings` | object | Objeto de configuración del formulario |
| `theme` | object | Referencia del tema |
| `workspace` | object | Referencia del espacio de trabajo |
| `fields` | array | Array de campos del formulario creados \(vacío si no se agregó ninguno\) |
| `welcome_screens` | array | Array de pantallas de bienvenida \(vacío si no hay ninguna configurada\) |
| `thankyou_screens` | array | Array de pantallas de agradecimiento |
| `_links` | object | Enlaces de recursos relacionados incluyendo URL pública del formulario |

### `typeform_update_form`

Actualizar un formulario existente usando operaciones JSON Patch

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de acceso personal de Typeform |
| `formId` | string | Sí | Identificador único del formulario a actualizar |
| `operations` | json | Sí | Array de operaciones JSON Patch \(RFC 6902\). Cada operación necesita: op \(add/remove/replace\), path, y value \(para add/replace\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de confirmación de éxito |

### `typeform_delete_form`

Eliminar permanentemente un formulario y todas sus respuestas

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de acceso personal de Typeform |
| `formId` | string | Sí | Identificador único del formulario a eliminar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `deleted` | boolean | Si el formulario se eliminó correctamente |
| `message` | string | Mensaje de confirmación de eliminación |
