Solved error RuntimeError [400] [131008] in make.com for WhatsApp Flow

Before diving into the details on how to resolve the RuntimeError [400] [131008] in make.com, it is essential to understand what WhatsApp Flow and make.com are, and how they integrate for message automation.

What is WhatsApp Flow?

WhatsApp Flow allows you to automate the sending of forms such as surveys via WhatsApp using the WhatsApp Business API. This tool is ideal for businesses that want to enhance their communication with customers in an automated way without leaving WhatsApp. If you want to learn more about how WhatsApp Flow works, I offer a free kit to test the WhatsApp API, available at this link: WhatsApp API Test Kit.

make.com is an automation platform that integrates with multiple services, including the WhatsApp API, to automate tasks like message sending. Although it is a powerful tool, it currently does not natively support the sending of WhatsApp Flows, which can result in errors such as:

(#131008) Required parameter is missing
Please specify a flow button component within template['components']

when trying to send a WhatsApp API template from make.com.

How to Solve the RuntimeError [400] [131008]?

The RuntimeError [400] [131008] in make.com occurs due to the lack of native support for sending WhatsApp Flows. Below, I will show you how I solved this issue in my project by manually integrating the WhatsApp Business API into make.com.

To solve this problem, we will not use the native WhatsApp Business API integration in make.com. Instead, we will manually configure it by following these steps:

Preparation: Prerequisites

Before starting the configuration, make sure you have the following:

Configuration in make.com

Step 1: Scenario Setup

In make.com, create or select an existing scenario. In my case, I already had a scenario configured with a Webhook that receives a JSON and sends the information to Google Spreadsheets as shown in the following image. I will use this setup as the basis for testing.

Step 2: Create a “HTTP Make a Request” Module

2. Fill in the fields as follows:

Step 3: Configure the Request Content Body

Now comes a crucial part. In “Request content”, enter the following JSON. Note that this is an example; you need to fill it with your data:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{Numero_Whatsapp_destino}}", // Recipient's phone number in E.164 format (e.g., 525555555555)
  "type": "template",
  "template": {
    "name": "{{Nombre_template}}", // Name of your WhatsApp Business template
    "language": {
      "code": "{{Codigo_idioma_pais}}" // Language code of the template, e.g., "es_MX"
    },
    "components": [
      {
        "type": "button",
        "sub_type": "flow",
        "index": "0",
        "parameters": [
          {
            "type": "action",
            "action": {
              "flow_token": "unused",
              "flow_action_data": {
                "flow_id": "{{ID_Del_Template_Whatsapp}}", // ID of the WhatsApp form
                "flow_action": "NAVIGATE",
                "navigate_screen": "SURVEY"
              }
            }
          }
        ]
      }
    ]
  }
}


Do not close or save anything yet; let’s proceed to the next step.

Step 4: Example of Correct Configuration

Below is an example of what a correctly configured Request content should look like:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "525555555555",
  "type": "template",
  "template": {
    "name": "encuesta_loyal_cliente_rating",
    "language": {
      "code": "es_MX"
    },
    "components": [
      {
        "type": "button",
        "sub_type": "flow",
        "index": "0",
        "parameters": [
          {
            "type": "action",
            "action": {
              "flow_token": "unused",
              "flow_action_data": {
                "flow_id": "130698640948414",
                "flow_action": "NAVIGATE",
                "navigate_screen": "SURVEY"
              }
            }
          }
        ]
      }
    ]
  }
}

Step 5: Testing and Verification

Once you have configured everything, it is time to run a test to ensure that the WhatsApp Flow sends correctly without any issues. But before anything else, don’t forget to click OK and save your scenario.

Step 6: Execute the Test

Run a test to check that the flow works correctly. Here’s an example of how it should look:

https://danielamoros.com/wp-content/uploads/2024/08/2024-08-24-13-58-44.mkv

Conclusion: Optimize Your WhatsApp Flow Integration in make.com

By following this step-by-step guide, you should be able to resolve the RuntimeError [400] [131008] and successfully integrate WhatsApp Flows in make.com without any problems. Remember, the key lies in the manual configuration of the WhatsApp API.

Buy Me a Coffee!

I hope this tutorial was helpful in effectively integrating and sending WhatsApp Flows in make.com. If it helped clear up your doubts or made your job easier, consider buying me a coffee! Your support helps me continue to create quality content. If you want to learn more about marketing, subscribe.

Buy me a coffee ☕ via PayPal

Solución al Error RuntimeError [400] [131008] en make.com para WhatsApp Flow

Antes de entrar en detalles sobre cómo resolver el error RuntimeError [400] [131008] en make.com, es importante entender qué son WhatsApp Flow y make.com y cómo se integran para la automatización de mensajes.

¿Qué es WhatsApp Flow?

WhatsApp Flow permite automatizar el envío de formularios como encuestas vía WhatsApp utilizando la API de WhatsApp Business. Esta herramienta es ideal para empresas que desean mejorar la comunicación con sus clientes de manera automatizada sin salir de Whatsapp. Si quieres profundizar más sobre cómo funciona WhatsApp Flow, te ofrezco hasta un kit gratuito para probar la API de WhatsApp, disponible en este enlace: Kit de Pruebas para WhatsApp API.

make.com es una plataforma de automatización que se integra con múltiples servicios, incluida la API de WhatsApp, para automatizar tareas como el envío de mensajes. Aunque es una herramienta poderosa, actualmente no soporta de forma nativa el envío de WhatsApp Flows, lo cual puede generar errores como el

(#131008) Required parameter is missing
Please specify a flow button component within template['components']

 al intentar integrar un enviar un template de WhatsApp API desde Make.com.

¿Cómo Resolver el Error RuntimeError [400] [131008]?

El error RuntimeError [400] [131008] en make.com se produce debido a la falta de soporte nativo para el envío de WhatsApp Flows. A continuación, te mostraré cómo solucioné este problema en mi proyecto integrando manualmente la API de WhatsApp Business en make.com.

Para resolver este problema, no utilizaremos la integración nativa de WhatsApp Business API en make.com. En su lugar, realizaremos la configuración de manera manual siguiendo estos pasos:

Preparación: Requisitos Previos

Antes de comenzar con la configuración, asegúrate de tener lo siguiente:

Configuración en make.com

Paso 1: Configuración del Escenario

En make.com, crea o selecciona un escenario existente. En mi caso, ya tenía un escenario configurado con un Webhook que recibe un JSON y envía la información a Google Spreadsheets como en la siguiente imagen, usare esta base para hacer las pruebas.

Paso 2: Crear un Módulo “Make a Request”

Dentro del escenario, crea un nuevo módulo de tipo “HTTP Make a Request”.

Rellena los campos de la siguiente manera:

Paso 3: Configuración del Cuerpo de la Solicitud (Request Content)

Ahora viene una parte crucial. En “Request content”, vas introducir el siguiente JSON, ojo, este es un ejemplo lo tienes que llenar con tus datos:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{Numero_Whatsapp_destino}}", // Número de destino en formato E.164 (ej. 525555555555)
  "type": "template",
  "template": {
    "name": "{{Nombre_template}}", // Nombre de la plantilla de WhatsApp Business
    "language": {
      "code": "{{Codigo_idioma_pais}}" // Código de la región de la plantilla, ej. "es_MX"
    },
    "components": [
      {
        "type": "button",
        "sub_type": "flow",
        "index": "0",
        "parameters": [
          {
            "type": "action",
            "action": {
              "flow_token": "unused",
              "flow_action_data": {
                "flow_id": "{{ID_Del_Template_Whatsapp}}", // ID del formulario de WhatsApp
                "flow_action": "NAVIGATE",
                "navigate_screen": "SURVEY"
              }
            }
          }
        ]
      }
    ]
  }
}


Ahora aun no cierres nada ni guardes vamos con el siguiente paso.

Paso 4: Ejemplo de Configuración Correcta

A continuación, un ejemplo de cómo debería verse un Request content correctamente configurado:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "525555555555",
  "type": "template",
  "template": {
    "name": "encuesta_loyal_cliente_rating",
    "language": {
      "code": "es_MX"
    },
    "components": [
      {
        "type": "button",
        "sub_type": "flow",
        "index": "0",
        "parameters": [
          {
            "type": "action",
            "action": {
              "flow_token": "unused",
              "flow_action_data": {
                "flow_id": "130698640948414",
                "flow_action": "NAVIGATE",
                "navigate_screen": "SURVEY"
              }
            }
          }
        ]
      }
    ]
  }
}

Paso 5: Prueba y Verificación

Una vez que hayas configurado todo, es momento de realizar una prueba para asegurarte de que el WhatsApp Flow se envía correctamente sin problemas. Pero antes de todo no olvides dar ok y guarda tu escenario.

Paso 6: Ejecución de la Prueba

Haz una prueba para comprobar que el flujo funciona correctamente. Aquí tienes un ejemplo de cómo se vería:

https://danielamoros.com/wp-content/uploads/2024/08/2024-08-24-13-58-44.mkv

Conclusión: Optimiza tu Integración de WhatsApp Flow en make.com

Siguiendo esta guía paso a paso, deberías poder solucionar el error RuntimeError [400] [131008] y lograr integrar WhatsApp Flows en make.com sin problemas. Recuerda, la clave está en la configuración manual de la API de WhatsApp.

¡Invítame un café!

Espero que este tutorial te haya sido útil para integrar y enviar WhatsApp Flows de manera efectiva en make.com. Si te ayudó a resolver tus dudas o facilitó tu trabajo, ¡invítame un café! Tu apoyo me permite seguir creando contenido de calidad. Si quieres conocer más sobre marketing, suscríbete.

Invítame un café ☕ vía PayPal

Cómo Enviar WhatsApp Flows: Envía Formularios de Encuesta

Los WhatsApp Flows son una herramienta poderosa que te permite enviar formularios de encuesta directamente a través de la API de WhatsApp. A continuación, te guiaré paso a paso para configurar y enviar un flujo (Flow) en WhatsApp, integrando un formulario de encuesta.

¿Qué es un WhatsApp Flow?

Un WhatsApp Flow es un tipo de mensaje estructurado que permite a las empresas enviar encuestas, formularios o series de preguntas a través de WhatsApp. Es ideal para recopilar información de los usuarios de manera directa y efectiva, utilizando la API de WhatsApp.

Configuración Inicial de WhatsApp en Meta Business

Antes de empezar, es importante tener configurada tu cuenta de WhatsApp en Meta Business. Si aún no lo has hecho, sigue estos pasos:

  1. Crea o accede a tu cuenta en Meta Business.
  2. Configura WhatsApp en Meta Business: Sigue el tutorial en video que he preparado, donde explico cómo realizar la configuración inicial para que puedas tener WhatsApp Business activo y listo para usar.

Configuración del Flow en WhatsApp

Una vez que tengas tu cuenta configurada, el siguiente paso es crear un Flow en WhatsApp.

Selecciona o crea una Plantilla de Mensaje:

En el administrador de Meta Business, selecciona la plantilla que mejor se adapte a tus necesidades. Debe ser una plantilla que permita el flujo de preguntas y respuestas, comúnmente conocida como “flujo” o “flow”.

Configura las Preguntas del Cuestionario:

Define las preguntas que deseas incluir en tu encuesta, asegúrate de hacer bien las preguntas porque después no se pueden editar amenos que crees una nueva plantilla.

  1. Configura el orden y la lógica de las preguntas dentro de la plantilla.
  2. Una vez configurado, envía la plantilla para su aprobación por parte de WhatsApp.
  3. Nota: La aprobación puede tardar un poco, así que asegúrate de hacerlo con antelación.

Obtención del ID del Template

Para enviar un WhatsApp Flow, necesitas el ID del template aprobado. Esta es una parte un poco confusa, no funciona igual que el envío de un mensaje normal, de hecho si intentas hacerlo donde solo de las el nombre al template y le das en send, te aparecerá un mensaje de error como este:

El mensaje es el siguiente:

{
	"error": {
		"message": "(#131008) Required parameter is missing",
		"type": "OAuthException",
		"code": 131008,
		"error_data": {
			"messaging_product": "whatsapp",
			"details": "Please specify a flow button component within template['components']"
		},
		"fbtrace_id": "ALu2UAo6yFD12VlDQU1XloN"
	}
}

Para poderlo enviar, igual será necesario hacer una solicitud diferente en el cuerpo del json en el mensaje.

¿Cómo obtengo el ID de mi Flujo de Whatsapp?

Vamos por partes, primero hay que hacer los siguientes pasos:

  1. Consulta los Templates:
    • Para esto, necesitamos pedirle a Meta vía API, que nos de las plantillas que tiene que hemos creado y que estén en nuestra, para lograr eso necesitaremos hacer una solicitud GET a un endpoint, el cual es:
      https://graph.facebook.com/v20.0/{{WhatsApp-Business-ID}}/message_templates
    • El {{WhatsApp-Business-ID}} es el ID de tu cuenta, para poderlo hacer fácilmente cree un KIT en Postman.
    • Si eres un mortal y no sabes de lo que estoy hablando note te preocupes, lo que necesitamos hacer es ir a Postman y crear una cuenta gratis y tienes que copiar un proyecto que cree para hacerlo fácilmente siguiendo este tutorial. Puedes hacer un fork de este kit aquí.
  2. Configura el Entorno en Postman:
    • Una vez hiciste fork al kit tienes que configurar los datos de tu cuenta de Meta, para eso necesitamos tu Business ID
    • Asegúrate de agregar el Access Token de Meta y el Business ID en el entorno de Postman, hazlo como en la siguiente imagen:
      1. Dirígete a Environments.
      2. Dale clic en test y asegúrate que este la palomita en test.
      3. Llena los datos, donde dice token, WhatsApp-Phone-ID, WhatsApp-Business-ID y Recipient-Phone-Number, son los datos de tu cuenta y el número de pruebas.
      4. Dale en Save
  • Iremos a la sección de Collections, y abriremos “GetWhatsappTemplates“.
  • Realizaremos una solicitud tipo GET usando el endpoint que se llama GetWhatsappTemplates mencionado para obtener todas las plantillas, ósea que le vamos a pedir a Meta si porfa nos ayuda con la info que tiene.
  • Puedes filtrar por categoría (en el caso de tener muchos) usando ?category=utility al final de la URL:
    https://graph.facebook.com/v20.0/{{WhatsApp-Business-ID}}/message_templates?category=utility
  • Antes de iniciarAsegúrate que el el Environment sea el que estas usando
  • Ahora si vamos nuevamente a darle en Send
  1. Respuesta de la Solicitud GET Encuentra y Copia el ID del Template:
    • Revisa la respuesta de la solicitud y encuentra el template que has configurado.
    • Copia el ID del template, ya que lo necesitarás para enviar el Flow. Y con eso hemos conseguido el tan aclamado flow_id del template.

Envío del WhatsApp Flow

Ahora que tienes el ID del template, estás listo para enviar la encuesta.

  1. Configura el Endpoint de Envío:
    • En Postman, utiliza el endpoint configurado en la colección para enviar el Flow. Este se llama SendWhatsAppFlow.
    • Ve a la pestaña de Body y elimina cualquier comentario en gris que solo sirve como explicación; dejarlos puede causar errores en la solicitud, debe de verse algo así con los datos de tu template.
    • Hay que consumir el endpoint:
      https://graph.facebook.com/v20.0/{{WhatsApp-Phone-ID}}/messages
    • El {{WhatsApp-Phone-ID}} es el ID del teléfono que te da Meta, tienes que hacer el envío de Whatsapp normal, solo agregando unas cosas como en la siguiente imagen en la parte de components. El Json debería ser algo asi:
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{Recipient-Phone-Number}}", 
  "type": "template",
  "template": {
    "name": "encuesta_test_dani", 
    "language": {
      "code": "es_MX"
    },
    "components": [
      {
        "type": "button",
        "sub_type": "flow",
        "index": "0",
        "parameters": [
          {
            "type": "action",
            "action": {
              "flow_token": "unused", 
              "flow_action_data": {
                "flow_id": "", 
                "flow_action": "NAVIGATE",
                "navigate_screen": "SURVEY"
              }
            }
          }
        ]
      }
    ]
  }
}
  1. Configura el Número de Teléfono:
    • Asegúrate de que el número de teléfono que estás usando para las pruebas esté correctamente configurado en el entorno de Postman.
    • Debe estar en el formato correcto sin el símbolo “+” (por ejemplo, 521228217000).
  2. Envía la Solicitud:
    • Una vez que todo esté configurado y los comentarios hayan sido eliminados, presiona Send.
    • Si todo está correcto, deberías recibir la encuesta en el número de prueba configurado.

Configuración de Webhook para la Recepción del Formulario

Finalmente, para recibir las respuestas del formulario, deberás configurar un Webhook. Sigue las instrucciones en la documentación de Facebook para asegurarte de que las respuestas se registren correctamente, solo resta parsear la información y listo

Documentación de Referencia

¿Te Sirvió este Tutorial?

Espero que este tutorial te haya sido útil para integrar y enviar WhatsApp Flows de manera efectiva. Si te ayudó a resolver tus dudas o facilitó tu trabajo, ¡invítame un café! Tu apoyo me permite seguir creando contenido de calidad. Si quieres conocer más de marketing suscríbete.

Invítame un café ☕ vía PayPal

Salir de la versión móvil