send_carousel en configuration.follow_up.actions para enviar tarjetas
con imágenes por DM de Instagram. Cada tarjeta tiene un título y botones de
enlace. Un mensaje después de las tarjetas es una acción separada en la misma
secuencia.
Campos y límites de las tarjetas
Los títulos de tarjetas y botones no pueden tener espacios en blanco al inicio
ni al final. Los límites cuentan valores escalares Unicode, que pueden diferir
de la longitud de una cadena en JavaScript. Usa URLs válidas, incluidos el
puerto y la codificación porcentual.
Usa el formato público
cards. Se rechazan propiedades desconocidas como
elements y default_action, o un botón de tarjeta con type: "postback".
Prepara las imágenes
Aloja cada imagen en una URL que abra sin iniciar sesión y mantenla disponible hasta el envío. Las tarjetas aceptan imágenes. La carga desde el panel acepta archivos JPG, PNG y GIF de hasta 8 MiB. REST y MCP reciben URLs y no tienen una operación de carga de medios. La validación de la configuración no descarga la imagen ni comprueba su tamaño; guardar la configuración no demuestra que Instagram pueda acceder al archivo.Crea una automatización completa
Este ejemplo envía un DM de apertura cuando un comentario coincide con la palabra clave. El clic en su botónstart_follow_up inicia la secuencia del
carrusel. Enviar solo la apertura no la inicia. Los clics en los enlaces de las
tarjetas no reanudan la secuencia ni renuevan la ventana de mensajes de 24 horas.
Guarda este cuerpo completo de solicitud como carousel.json. Sustituye el
UUID de ejemplo por el ID de una cuenta accesible y cada URL de ejemplo por
una tuya. Los mensajes, la palabra clave, la pausa de cinco segundos, las
respuestas públicas desactivadas y el intervalo entre activaciones son
opciones ilustrativas. status: "draft" guarda el ejemplo para revisión.
automations:write y acceso a la cuenta:
status: "live" también requiere automations:activate y que la
cuenta sea elegible. Consulta Crear una automatización
para conocer la respuesta y las reglas de reintento cuando el resultado de la
creación sea incierto. No repitas automáticamente una creación cuyo resultado
desconozcas.
Programa el siguiente mensaje
La acciónsend_message está separada de los botones de las tarjetas. Su
delay_seconds es relativo a la finalización correcta de la acción anterior.
El ejemplo programa la invitación al grupo cinco segundos después del envío
correcto del carrusel. No espera a que la persona vea una tarjeta, haga clic
en un enlace o entre al grupo.
Las esperas configuradas deben caber en la ventana de mensajes aplicable. Las
pausas y los reintentos no amplían esa ventana. El espaciado compartido por
cuenta y las esperas del proveedor pueden retrasar el envío más allá de la
pausa configurada. Esto es independiente de los límites de solicitudes
de la API HTTP; crear una automatización no promete un envío inmediato ni una
cuota fija de mensajes por hora.
Consulta, edita y gestiona errores
Consulta la automatización después de guardar y comprueba el orden de las tarjetas, los botones, la siguiente acción y el estado almacenados. Al editar, envía la configuración completa y unexpected_updated_at actualizado mediante
Actualizar una automatización. Reemplazar la
configuración no es una actualización parcial de una tarjeta. Sigue las reglas
de publicación de ese endpoint para automatizaciones activas con cambios sin
publicar.
Los campos no válidos devuelven 422 con
api_automation_invalid_configuration y problemas en error.details.issues.
Revisa la ruta indicada: demasiadas tarjetas, un cuarto botón, una URL no válida
o la falta de la pausa obligatoria necesitan corrección. Conserva el resto de
la configuración al corregir un campo.
Los clientes que enumeran los tipos de acciones de continuación deben manejar
send_carousel en las solicitudes y en las configuraciones devueltas. Consulta
el documento OpenAPI actual antes de crear un decodificador
que enumere todos los tipos. Para el mismo flujo con un agente, usa
Carruseles mediante MCP.