Prompteo

Unidad 5 · 2 min

Recordatorios: la skill que sirve

Permisos vigentes, consent token deprecado y la Reminders API: cómo Mi Agenda crea recordatorios reales.

Recordatorios: la skill que sirve

Hasta acá Mi Agenda entiende lo que le decís y te contesta. Ahora le vas a dar una razón real para existir: crear recordatorios de verdad en la cuenta de Alexa de quien la usa, con la Reminders API.

Dos permisos, no uno

Para crear un recordatorio hacen falta dos consentimientos distintos: el permiso global alexa::alerts:reminders:skill:readwrite, que el usuario otorga una vez, y el consentimiento explícito para CADA recordatorio puntual, porque Amazon exige pedirlo de nuevo cada vez que se crea uno.

El patrón para detectar el permiso

El campo consentToken está deprecado: no sirve para chequear si hay permiso, aunque lo menciones en tutoriales viejos. El patrón vigente es intentar la llamada con el apiAccessToken y mirar el código de respuesta — un 403 Forbidden significa que falta el permiso, y ahí corresponde devolver una tarjeta AskForPermissionsConsent. Para recordatorios existe además un flujo de permiso por voz, con directivas Connections.SendRequest y Connections.Response, que evita mandar al usuario a la app.

Crear el recordatorio

El cuerpo del POST a /v1/alerts/reminders define un trigger (absoluto o relativo), el texto que Alexa va a decir en alertInfo.spokenInfo.content, y si dispara una notificación push. La API también expone GET, PUT y DELETE — pero solo sobre los recordatorios que la propia skill creó: no se puede leer ni modificar lo que el usuario pidió por voz nativa o por otra skill.