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
401Clave ausente, con formato incorrecto, no válida o revocada.403El 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
401Clave ausente, con formato incorrecto, no válida o revocada.403El 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
400JSON no válido, o targetUrl no es una URL HTTPS de hooks.zapier.com.401Clave ausente, con formato incorrecto, no válida o revocada.403El plan del espacio de trabajo no incluye webhooks (Pro o superior), o la suscripción no está activa.403Se alcanzó el límite de webhooks del plan.413El 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
400El ID no es un UUID.401Clave 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
- Inicia sesión en typehop.com/zapier/connect y crea una clave de Zapier.
- En Zapier, conecta TypeHop con esa clave, elige New Dictation y activa el Zap.
- 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.