Creación y edición de WhatsApp flujos

Puede crear un WhatsApp flujo mediante la consola social de mensajería para el usuario AWS final o la API social de mensajería para el usuario AWS final. Al crear un flujo, se coloca en estado BORRADOR. Si lo desea, puede proporcionar una definición de Flow JSON en el momento de la creación o añadirla más adelante mediante la operación de actualización de activos.

Crear un flujo (consola)

1. Abra la consola social de mensajería para usuarios AWS finales en https://console.aws.amazon.com/social-messaging/.

2. Elija una cuenta empresarial y, a continuación, una WABA.

3. Selecciona la pestaña Flujos.

4. Elija Crear flujo.

5. En Nombre del flujo, introduce un nombre único para tu flujo. Los nombres de los flujos deben ser únicos en la WABA (máximo 200 caracteres).

6. En Categoría, selecciona una o más categorías que describan el propósito comercial de tu flujo. Se requiere al menos una categoría. Las categorías disponibles son:

   • Inscripción

   • Iniciar sesión

   • Reserva de cita

   • Generación de leads

   • Contacto

   • Atención al cliente

   • Encuesta

   • Compras

   • Otro

7. En el caso de la plantilla, elige una plantilla prediseñada para empezar o selecciona Predeterminada para empezar con un flujo en blanco. Las siguientes plantillas están disponibles sin un punto final:

   • Predeterminada: plantilla inicial en blanco

   • Recopile los intereses de compra: recopile información de los posibles compradores

   • Obtenga comentarios: recopile los comentarios de los clientes

   • Envía una encuesta: crea una encuesta con varias preguntas

   • Atención al cliente: recopile los detalles de las solicitudes de asistencia

8. Seleccione Crear.

Después de crear el flujo, puede editar el JSON del flujo para personalizar las pantallas y los componentes. La vista previa del flujo, en la parte derecha de la página, muestra una vista previa en tiempo real del aspecto que tendrán los usuarios de tu flujo WhatsApp.

Crear un flujo (API)

Usa la CreateWhatsAppFlow API para crear un flujo nuevo. En el siguiente ejemplo, se utiliza AWS CLI para crear un flujo con un nombre y una categoría:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_lead_generation_form" \
    --categories '["LEAD_GENERATION"]'

La respuesta incluye el ID de flujo asignado por Meta:

{
    "flowId": "{FLOW_ID}",
    "validationErrors": []
}

También puedes proporcionar una definición de Flow JSON en el momento de la creación y publicarla inmediatamente:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "appointment_booking" \
    --categories '["APPOINTMENT_BOOKING"]' \
    --flow-json fileb://flow.json \
    --publish

nota

Si lo incluyes--publish, el JSON de Flow debe ser válido y superar la validación de Meta. Si hay errores de validación, el flujo se crea en estado BORRADOR y los errores se devuelven en el validationErrors campo.

Para clonar un flujo existente dentro del mismo WABA:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "lead_form_v2" \
    --categories '["LEAD_GENERATION"]' \
    --clone-flow-id {FLOW_ID}

Actualización de un flujo

Hay dos tipos de actualizaciones que puede realizar en un flujo:

• Actualizar los metadatos: cambie el nombre o las categorías del flujo medianteUpdateWhatsAppFlow.

• Actualizar activos: cambie la definición de Flow JSON medianteUpdateWhatsAppFlowAssets.

importante

Al actualizar los activos de un flujo publicado, se restablece su estado a BORRADOR. Debe volver a publicar el flujo para que esté disponible para su uso en los mensajes.

En el siguiente ejemplo, se actualiza el nombre de un flujo:

aws socialmessaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-name "updated_lead_form"

El siguiente ejemplo actualiza la definición de JSON de un flujo:

aws socialmessaging update-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-json fileb://updated_flow.json

Si el JSON de Flow contiene errores de validación, se muestran en la respuesta. Debe corregir estos errores antes de poder publicar el flujo.

Listado y visualización de los flujos

Se utiliza ListWhatsAppFlows para ver todos los flujos de una WABA y GetWhatsAppFlow para recuperar detalles sobre un flujo específico.

Enumere todos los flujos:

aws socialmessaging list-whatsapp-flows \
    --id {WABA_ID}

Obtenga detalles de un flujo específico:

aws socialmessaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

La GetWhatsAppFlow respuesta incluye el estado del flujo, las categorías, los errores de validación, la versión JSON, la información de vista previa y el estado de salud.

Para recuperar la definición de JSON de Flow (activos), utiliceListWhatsAppFlowAssets:

aws socialmessaging list-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

La respuesta incluye una URL de descarga prefirmada para el archivo JSON de Flow. La URL caduca tras un breve periodo de tiempo. No se necesita ninguna autenticación adicional para descargar el archivo desde la URL.

Eliminar un flujo

Solo puede eliminar los flujos que estén en estado BORRADOR. Los flujos publicados u obsoletos no se pueden eliminar.

Para eliminar un flujo mediante la consola, seleccione el flujo en la pestaña Flujos y elija Eliminar.

Para eliminar un flujo mediante la API:

aws socialmessaging delete-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

aviso

La eliminación de un flujo es permanente y no se puede deshacer.