Conectar Zapier o n8n

Zapier y n8n son herramientas de automatización. Pueden pasar datos de casi cualquier otra app a BytePhase. Por ejemplo, una fila nueva en una hoja de cálculo puede convertirse en un prospecto.

Antes de empezar

• Necesita una cuenta de Zapier o n8n. En Zapier, el paso Webhooks by Zapier es una función de pago de Zapier.
• Puede conectarlo en todos los planes. Para ver las consultas, necesita el plan Standard o superior.
• Ayuda contar con alguien que ya haya creado un Zap o un flujo de n8n.

Pasos

1. Vaya a Configuración › Integraciones. En Web y formularios, haga clic en Conectar en Zapier o n8n.

2. Elija Autorregistro o Prospecto y haga clic en Siguiente.

3. Copie la Clave API y la URL del endpoint. En Zapier, también verá una URL base de la API.

   La clave API solo se muestra una vez. Cópiela ahora.

   

   Computadora

4. Cree la conexión en su herramienta. Cómo conectar en la pantalla muestra los pasos:

   • Zapier: en su Zap, añada una acción Webhooks by Zapier › POST. Pegue la URL del endpoint y añada su clave API como se indica en pantalla. O, en Zapier, busque “BytePhase” y conecte con la clave API y la URL base de la API.
   • n8n: añada un nodo HTTP Request, haga clic en Import cURL y pegue el ejemplo de curl de Ejemplos de código.

   Las secciones de abajo muestran qué elegir dentro de Zapier y n8n.

5. Haga una prueba desde su herramienta: el paso Test de Zapier, o ejecute el nodo de n8n. Después haga clic en Comprobar ahora en BytePhase.

   Verá Envío de prueba capturado.

6. Haga clic en Siguiente en Asignar campos y en Si el cliente ya existe, y luego en Activar integración.

¡Listo!

Su Zap o su flujo de n8n crea ahora prospectos o autorregistros en BytePhase cada vez que se ejecuta.

Configurar el Zap en Zapier

1. En Zapier, haga clic en Create y luego en Zap.

2. Elija como disparador la app de la que vienen sus datos. Para Google Forms, elija New Form Response, no New or Updated Form Response. Si no, una respuesta editada crea un segundo prospecto.

3. Haga clic en Test trigger para que Zapier encuentre una entrada reciente. Si no encuentra nada, llene usted mismo su formulario una vez y vuelva a probar.

4. Añada una acción: Webhooks by Zapier y luego POST. Llénela así:

   • URL: la URL del endpoint de BytePhase.
   • Payload Type: Json. Wrap Request In Array: No. Unflatten: Yes.
   • Headers: añada X-API-Key con su clave API. Añada también Content-Type y Accept, ambos con el valor application/json.
   • Data: copie la forma del ejemplo de curl de Ejemplos de código. Sus campos van dentro de data. Llene cada valor con el selector de Zapier en lugar de escribirlo.

5. Si quiere, añada un paso Filter by Zapier antes de la acción. Deje pasar una entrada solo si tiene un nombre y un correo o un número de móvil. Así evita el spam.

6. Después de activar la integración en BytePhase, haga clic en Publish en Zapier.

Configurar el flujo en n8n

Import cURL llena el nodo HTTP Request por usted. Para llenarlo a mano:

1. Ponga Method en POST y URL en la URL del endpoint de BytePhase.

2. Añada dos cabeceras: X-API-Key con su clave API, y Content-Type con el valor application/json.

3. Envíe el cuerpo como JSON, con la misma forma que el ejemplo de curl. Sus campos van dentro de data.

4. Si los nombres de sus campos son distintos de los de BytePhase, añada antes un nodo Set. Cámbieles el nombre por los de Ver campos disponibles.

Guarde su clave API en las credenciales de n8n en lugar de escribirla en el nodo. Así no aparece si exporta el flujo.

Qué puede hacer la app de BytePhase en Zapier

Cuando conecta mediante la app de BytePhase en Zapier, una sola conexión le da:

• Triggers (algo pasa en BytePhase): un trabajo, cliente, prospecto, pago o trabajo externalizado nuevo, o un cambio de estado de un trabajo.
• Acciones (BytePhase hace algo): crear un cliente, crear un prospecto o añadir un autorregistro.
• Buscar: encontrar un cliente.

Conviene saber

• Para ver cada envío y si funcionó, use Ver actividad en la tarjeta.
• Para la lista completa de campos que acepta BytePhase, haga clic en Ver campos disponibles en el paso de conexión, o consulte developers.bytephase.com.
• Si su clave API se filtra, use Rotar clave en la página de actividad. Después actualice su Zap o su flujo con la clave nueva.
• Si Zapier repite un paso, BytePhase puede crear un segundo registro. Lo que evita las repeticiones es su elección en Si el cliente ya existe. En n8n, añada una cabecera Idempotency-Key con un valor único para cada entrada, para que una repetición se ignore.