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
401Clave ausente, mal formada, 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 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
401Clave ausente, mal formada, 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 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
400JSON no válido, o targetUrl no es una URL HTTPS de hooks.zapier.com.401Clave ausente, mal formada, 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 ha alcanzado el límite de webhooks del plan.413Cuerpo 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
400El ID no es un UUID.401Clave 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
- 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 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.