--- title: "Integración con ParticleIO" slug: "particleio-integration" status: "update" updated: 2026-10-22T18:03:50Z published: 2026-10-22T18:03:50Z canonical: "support.tulip.co/particleio-integration" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Integración con ParticleIO *Conecta fácilmente Tulip con los dispositivos ParticleIO* Sigue la guía de integración de la comunidad de Particle (guía idéntica) aquí:[Integración de la comunidad Particle <> Tulip](https://docs.particle.io/integrations/community-integrations/tulip/) ## Configuración ### Configuración del punto final de máquina de Tulip Para crear una máquina en Tulip se necesita lo siguiente:* Credenciales de la API* Tipo de máquina* **Credenciales de la API**:::(Info) (Feature rename) Prior to r383, Service Accounts were called "API Tokens". ::: Ve a «Configuración» --> «API de Tulip» para crear una cuenta de servicio con permisos de lectura y escritura sobre máquinas y atributos![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28203%29.png) **Tipo de máquina: Ve**a Planta de producción --> Máquinas --> Tipos de máquina y crea un nuevo tipo de máquina. Crea atributos de máquina que reflejen los eventos publicados desde ParticleIO. NOTA: El tipo de datos debe ser cadena. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28204%29.png) **Máquina: Crea**una nueva máquina bajo el tipo de máquina recién creado; en la configuración, asigna el atributo de la máquina a la API de Tulip Machine y anota el MachineId y el AttributeId![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28205%29.png) ### Activación de la integración **Consola de Particle: Ahora**que has completado toda la configuración previa necesaria, ya estás listo para habilitar la integración de Tulip en la consola de Particle. Empieza por acceder al centro de integraciones haciendo clic en el icono de integraciones de la barra lateral (), o simplemente siguiendo este enlace. Si deseas habilitar la integración para un producto, tendrás que visitar el centro de integraciones del producto en cuestión. Para ello, haz clic en el icono de productos () de la barra lateral, busca tu producto y, a continuación, haz clic en el icono de integraciones () en el contexto del producto. Una vez en el centro de integraciones, haz clic en el botón «Nueva integración». En la lista de integraciones disponibles, haz clic en «Webhook». El siguiente paso es configurar el Webhook. Rellena los siguientes campos: - Nombre del evento: El nombre del evento que activará la publicación de un evento en Tulip Machine. Este es el nombre de tu evento cuando llamas a Particle.publish() en tu firmware. - URL: La URL completa de la API de Tulip Machine. Ejemplo: https://[instance].tulip.co/api/v3/attributes/report - Tipo de solicitud: El servidor de Tulip espera una solicitud POST, así que asegúrate de que esa opción esté seleccionada. - Formato de la solicitud: El valor predeterminado es «Formulario web», pero vamos a enviar un JSON, así que asegúrate de cambiarlo a JSON. Tendrás que hacer clic en la sección «Configuración avanzada» para rellenar el formato JSON personalizado. Puedes rellenarlo de la siguiente manera: `{ "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{{PARTICLE_EVENT_VALUE}}}" } ]}` **Autenticación** Por último, tendrás que autenticarte en Tulip con la clave API y el secreto. A continuación se muestra una captura de pantalla a modo de ejemplo.![tulip_api_auth.jpg](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/tulip_api_auth.jpg) *En este caso, se utiliza la autenticación básica.* Haz clic en «Crear webhook». ¡Ya has indicado correctamente a la nube de Particle que transmita datos a Tulip a través de su MachineAPI! ¡Es hora de pasar al firmware! ### Firmware Ahora que la integración está habilitada en la nube de Particle, el último paso necesario para que los datos se transmitan a Tulip es flashear un dispositivo con un firmware que publique el evento en cuestión. Accede al IDE web de Particle, al IDE local o al IDE que estés utilizando para el desarrollo de firmware. Si ya estás trabajando en una aplicación de firmware, solo tienes que asegurarte de incluir una llamada a Particle.publish() con el nombre del evento que coincida con el utilizado para habilitar la integración con Google Cloud Platform anteriormente. De lo contrario, si necesitas un ejemplo de firmware, pega el código siguiente en tu aplicación de firmware: ``` void loop() { // datos aleatorios String data = String((rand()%100)+1); // Activar la integración Particle.publish("temperature", data, PRIVATE); // Esperar 6 segundos delay(6000);}```El código anterior publicará un evento cada 6 segundos, en el que se genera un número aleatorio y, a continuación, se publica en el evento de Webook. Adelante, programa el firmware con la función Particle.publish(), que activará la integración en un dispositivo Particle. ¡Enhorabuena! Esto es todo lo que necesitas para que la integración funcione de principio a fin. Tu dispositivo comenzará ahora a publicar el evento en cuestión, lo que indicará a la nube de Particle que transmita el contenido del evento a tu instancia de Tulip. ### Comprobación de que los datos llegan a Tulip Para asegurarte de que los datos se publican correctamente en Tulip, puedes consultar las actualizaciones de las máquinas en el área «Shop Floor» --> «Máquinas» ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28202%29.png){height="" width=""} NOTA: Es posible que el atributo deba estar en formato de cadena y convertirse posteriormente. ### Ejemplos de casos de uso El uso de placas ParticleIO, como la Boron404x, resulta ideal cuando la conexión Wi-Fi es deficiente y la red móvil ofrece una solución más rápida para la conectividad de los dispositivos. Entre los casos de uso se incluyen:\* Seguimiento de materiales\* Supervisión de máquinas\* Actualizaciones de calidad en tiempo real ```