TypeHop
Descargar

Desarrolladores · Zapier

Referencia de la API de Zapier de TypeHop

La app de TypeHop en Zapier tiene un solo disparador, New Dictation. Usa los cuatro endpoints de abajo y recibe un evento. Todo es JSON sobre HTTPS. Descarga la especificación OpenAPI 3.1.

Autenticación

Cada solicitud lleva una clave de Zapier dedicada como token Bearer. Una clave pertenece a un usuario en un espacio de trabajo. Crea o revoca claves en typehop.com/zapier/connect. El espacio de trabajo necesita un plan con webhooks (Pro o superior).

URL base
https://api.typehop.com/v1/zapier
Encabezado
Authorization: Bearer thp_zap_<64 hex characters>
Errores
Las respuestas que no son 2xx devuelven { "error": "<message>" } y nunca se almacenan en caché.

Probar una clave

GEThttps://api.typehop.com/v1/zapier/auth

Confirma que la clave es válida y que el espacio de trabajo puede usar webhooks. Devuelve el nombre del espacio de trabajo que Zapier muestra como etiqueta de la conexión.

Usado por: Prueba de autenticación

Respuesta · 200

{
  "accountLabel": "Acme workspace"
}

Errores

  • 401 Clave ausente, con formato incorrecto, no válida o revocada.
  • 403 El plan del espacio de trabajo no incluye webhooks (Pro o superior), o la suscripción no está activa.

Listar dictados recientes

GEThttps://api.typehop.com/v1/zapier/notes

Los diez dictados más recientes del dueño de la clave en ese espacio de trabajo, del más nuevo al más antiguo. Zapier los usa como datos de muestra mientras armas un Zap.

Usado por: Disparador New Dictation (performList)

Respuesta · 200

{
  "notes": [
    {
      "id": "a0cf17ac-0c67-49df-a875-05c84063161c",
      "cleanedText": "Idea: let teammates share a custom dictionary.",
      "startedAt": "2026-11-10T10:00:00.000Z",
      "source": "macos"
    }
  ]
}

Errores

  • 401 Clave ausente, con formato incorrecto, no válida o revocada.
  • 403 El plan del espacio de trabajo no incluye webhooks (Pro o superior), o la suscripción no está activa.

Suscribir un Zap

POSThttps://api.typehop.com/v1/zapier/subscriptions

Registra un REST hook de Zapier. Solo se aceptan URLs HTTPS en hooks.zapier.com. Suscribir la misma URL dos veces devuelve la suscripción existente. Cada suscripción cuenta para el límite de webhooks del plan.

Usado por: Disparador New Dictation (performSubscribe)

Cuerpo de la solicitud

{
  "targetUrl": "https://hooks.zapier.com/hooks/standard/123/abc/"
}

Respuesta · 201

{
  "id": "5d1f2c4e-8a1b-4f8e-9a77-3d2f6c1b0e21"
}

Errores

  • 400 JSON no válido, o targetUrl no es una URL HTTPS de hooks.zapier.com.
  • 401 Clave ausente, con formato incorrecto, no válida o revocada.
  • 403 El plan del espacio de trabajo no incluye webhooks (Pro o superior), o la suscripción no está activa.
  • 403 Se alcanzó el límite de webhooks del plan.
  • 413 El cuerpo de la solicitud supera los 4 KB.

Cancelar la suscripción de un Zap

DELETEhttps://api.typehop.com/v1/zapier/subscriptions/{id}

Elimina una suscripción creada con esta clave. Los ID desconocidos se procesan sin error, así que reintentar una cancelación es seguro.

Usado por: Disparador New Dictation (performUnsubscribe)

Respuesta · 204

Sin cuerpo.

Errores

  • 400 El ID no es un UUID.
  • 401 Clave ausente, con formato incorrecto, no válida o revocada.

El evento note.transcribed

Cuando un dictado está listo, TypeHop envía un POST a cada hook suscrito. Los encabezados incluyen x-talktome-event y x-talktome-event-id (note.transcribed:<note id>). Las entregas fallidas se reintentan con espera progresiva; el ID de la nota se mantiene igual, así que los duplicados pueden descartarse con él.

{
  "event": "note.transcribed",
  "timestamp": "2026-11-10T10:00:04.112Z",
  "note": {
    "id": "a0cf17ac-0c67-49df-a875-05c84063161c",
    "cleanedText": "Idea: let teammates share a custom dictionary.",
    "startedAt": "2026-11-10T10:00:00.000Z",
    "source": "macos"
  }
}

El disparador de Zapier devuelve cuatro campos: id, text (el texto limpio), createdAt y source.

Pruebas sin una Mac

  1. Inicia sesión en typehop.com/zapier/connect y crea una clave de Zapier.
  2. En Zapier, conecta TypeHop con esa clave, elige New Dictation y activa el Zap.
  3. De vuelta en la página de conexión, graba un dictado corto en el navegador o escribe una nota de prueba, y luego presiona Send to my Zaps.

El Zap se ejecuta en unos segundos. Preguntas: support@typehop.com. Página de la clave: https://typehop.com/zapier/connect.

Other products from us:SmashSend·TidySupport·SuperBuilder·Inbounter·Blossu·KnowledgeSDK