Las recetas a continuación son flujos de trabajo completos construidos con la API pública de Furcata. Cada una muestra las llamadas en orden, los campos que importan y los errores que son fáciles de cometer.
Las tres recetas se construyen con el mismo conjunto reducido de capacidades.
- Contactos — las personas a las que escribes, identificadas por su número de teléfono.
- Mensajes — un envío único a entre uno y cincuenta destinatarios.
- Webhooks — cómo Furcata le informa a tu sistema lo que ocurrió.
- Reportes — qué se envió y cuánto costó.
Un mensaje, muchos destinatarios
Un envío único acepta hasta cincuenta destinatarios. Para audiencias más grandes, envía por lotes en lugar de una sola solicitud enorme, y dale a cada lote una clave de idempotencia distinta para que un reintento no duplique el envío.
Cualquier envío puede reintentarse por tu propio código o por tu red. Una clave de idempotencia vincula un reintento con la solicitud original para que el destinatario reciba un mensaje, no dos. Genera la clave a partir de algo estable del envío — un id de pedido, un id de cita, un número de lote — y no de la hora actual.
Un envío solo te dice que Furcata aceptó el mensaje. Los resultados de entrega llegan por webhook. Suscríbete a los eventos de entrega y de fallo y trátalos como la fuente de verdad sobre si un mensaje llegó.
A un contacto que se ha dado de baja no se le envían mensajes, sin importar lo que pida tu flujo de trabajo. Diseña tu proceso asumiendo que se omitirá una fracción de cada lista, y no trates una omisión como un error.
Elige una receta y constrúyela
Cada receta es autónoma. Empieza con los recordatorios de citas: ejercita contactos, envíos, idempotencia y webhooks en un solo flujo pequeño.
Empieza con los recordatorios de citas