TypeHop
Descargar

Desarrolladores · Zapier

Referencia de la API de Zapier de TypeHop

La app de TypeHop en Zapier tiene un único disparador, New Dictation. Usa los cuatro endpoints que verás a continuación 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 exclusiva 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
Cabecera
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, mal formada, 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 propietario de la clave en ese espacio de trabajo, del más reciente al más antiguo. Zapier los usa como datos de ejemplo mientras creas 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, mal formada, 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 URL 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, mal formada, 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 ha alcanzado el límite de webhooks del plan.
  • 413 Cuerpo de la solicitud de más de 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 aceptan sin error, de modo que reintentar la 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, mal formada, no válida o revocada.

El evento note.transcribed

Cuando un dictado está listo, TypeHop envía un POST a cada hook suscrito. Las cabeceras 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 no cambia, así que los duplicados se pueden descartar usándolo.

{
  "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 un 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 pulsa 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