Webhook de captura

El webhook de captura convierte una nota de voz o un texto corto en una tarea de la bandeja de entrada. Cualquier dispositivo, aplicación o script que pueda enviar una solicitud HTTP envía el texto, y opcionalmente una grabación de audio, a tu propio servidor en la nube. El servidor crea la tarea, adjunta la grabación y tus dispositivos reciben ambas cosas en la siguiente sincronización.

Esto necesita el servidor en la nube autoalojado. Si usas Mindwtr sin servidor, captura desde el menú de compartir del teléfono o con Siri.

El endpoint

POST /v1/capture

Cada solicitud lleva el mismo token de portador que el resto de la API, en una cabecera Authorization: Bearer <token>. El cuerpo puede ser multipart/form-data, application/json con los mismos nombres de campo, o text/plain, donde todo el cuerpo es la transcripción. Solo multipart/form-data puede llevar audio: las solicitudes JSON y de texto plano son solo de texto, y un campo audio dentro del JSON se ignora. Los campos desconocidos se ignoran.

Solo texto

curl -X POST https://your-server.example/v1/capture \
  -H "Authorization: Bearer $MINDWTR_TOKEN" \
  -H "Content-Type: text/plain" \
  --data "Call the dentist about the crown"

Audio con una transcripción

curl -X POST https://your-server.example/v1/capture \
  -H "Authorization: Bearer $MINDWTR_TOKEN" \
  -F "transcription=Call the dentist about the crown" \
  -F "audio=@note.m4a" \
  -F "recordedAt=1756900000000" \
  -F "client=Pebble Index 01"

Campos

Campo	Qué hace
transcription	El texto capturado. La primera línea se convierte en el título de la tarea y el texto completo pasa a la descripción. text y title se aceptan como otros nombres del mismo campo.
audio	La grabación que se adjunta a la tarea. Se sincroniza con tus dispositivos como cualquier otro adjunto. Solo se lee de una solicitud multipart/form-data.
recordedAt	Cuándo se hizo la captura, en milisegundos desde la época o como marca de tiempo ISO 8601. Pasa a ser la hora de creación de la tarea cuando es válida y no está en el futuro.
client	Una etiqueta corta para el dispositivo o la aplicación que envió la captura. Se acepta y se ignora, para que remitentes como la app de Pebble sigan funcionando.
captureId	Opcional. Un UUID que elige el remitente para esta captura; pasa a ser el id de la nueva tarea. Si envías el mismo valor en un reintento, el servidor responde 200 con "replayed": true y no añade nada. Un valor mal formado se rechaza con 400.

Envía al menos uno de los campos transcription y audio. La grabación puede ser m4a, mp4, aac, mp3, wav, ogg o webm.

Respuestas

Estado	Significado
201	La tarea se creó. El cuerpo de la respuesta es la tarea nueva.
400	No se envió ni transcripción ni archivo de audio.
401	Falta el token o es incorrecto.
413	La solicitud supera el límite de tamaño del servidor: un audio por encima del límite de adjuntos, o una transcripción por encima del límite de texto.
415	El tipo del archivo de audio no es compatible.

Token solo de captura

Un dispositivo que solo captura no debería tener un token que pueda leer, cambiar y borrar todo lo que hay en tu cuenta. Un token solo de captura es un segundo secreto para la misma cuenta. El servidor lo acepta en POST /v1/capture y en ningún otro sitio.

Crea uno con tu token completo. El label es opcional. La respuesta muestra el token una sola vez. El servidor nunca lo guarda en claro, así que cópialo ahora.

curl -X POST https://your-server.example/v1/capture-tokens \
  -H "Authorization: Bearer $MINDWTR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"label":"Pebble ring"}'

{
  "id": "6f1c2d1e-8a4b-4c3e-9f2a-1b2c3d4e5f60",
  "token": "mwc_…",
  "label": "Pebble ring",
  "createdAt": "2026-09-06T10:12:00.000Z"
}

Lista los tokens de la cuenta. La respuesta lleva id, label y createdAt de cada token, y ningún secreto.

curl https://your-server.example/v1/capture-tokens \
  -H "Authorization: Bearer $MINDWTR_TOKEN"

Revoca uno por su id.

curl -X DELETE https://your-server.example/v1/capture-tokens/<id> \
  -H "Authorization: Bearer $MINDWTR_TOKEN"

• Un token solo de captura funciona únicamente en POST /v1/capture. Ahí se comporta exactamente igual que el token completo: mismos formatos de cuerpo, mismas respuestas, mismo límite de tasa que la cuenta. Cualquier otra ruta responde 403.
• Una cuenta puede tener hasta 20 tokens solo de captura.
• En modo de lista de permitidos, un token solo de captura deja de funcionar cuando el token completo de la cuenta se quita de la lista.

Pebble Index 01

La aplicación del Pebble Index 01 envía notas de voz exactamente en este formato y permite añadir tus propias cabeceras de solicitud. Por eso no hace falta código intermedio: solo rellenas dos ajustes.

1. Abre la aplicación de Pebble en el teléfono y ve a los ajustes de webhook para las notas de voz
2. Pon la URL del webhook en https://your-server.example/v1/capture, con la dirección de tu propio servidor en lugar del ejemplo
3. Añade una cabecera de solicitud llamada Authorization con el valor Bearer <token>, usando un token solo de captura de la sección anterior. Tu token completo también funciona, pero el token solo de captura es la opción más segura para un dispositivo que solo graba notas
4. Graba una nota en el reloj. Llega a tu bandeja de entrada en la siguiente sincronización, con la transcripción como tarea y la grabación adjunta

Otros dispositivos y automatizaciones

Nada de esto es exclusivo de Pebble. Cualquier cosa que pueda hacer un POST HTTP funciona igual:

• Atajos de iOS y Apple Watch: una acción Obtener contenido de URL, método POST, con la cabecera y un campo de texto. Consulta la receta Capturar desde el Apple Watch en la página de Atajos de Apple
• Aplicaciones de automatización de Android como Tasker: una acción de solicitud HTTP con la misma URL y la misma cabecera
• Home Assistant: un rest_command que envía el texto de una automatización o de una respuesta del asistente de voz
• Scripts de shell y tareas cron: los comandos curl de arriba, con el token en una variable de entorno

Páginas relacionadas

• API de la nube
• Captura por correo electrónico
• Despliegue con Docker