Collegare Zapier o n8n

Zapier e n8n sono strumenti di automazione. Possono passare a BytePhase dati da quasi qualsiasi altra app. Per esempio, una nuova riga in un foglio di calcolo può diventare un lead.

Prima di iniziare

• Ti serve un account Zapier o n8n. In Zapier, il passaggio Webhooks by Zapier è una funzione a pagamento di Zapier.
• Puoi collegarlo con qualsiasi piano. Per vedere le richieste ti serve il piano Standard o superiore.
• Aiuta avere qualcuno che ha già creato uno Zap o un workflow n8n.

Passaggi

1. Vai in Impostazioni › Integrazioni. Sotto Sito web e moduli, clicca su Collega in Zapier o n8n.

2. Scegli Check-in autonomo o Lead, poi clicca su Avanti.

3. Copia la Chiave API e l’URL dell’endpoint. Per Zapier vedi anche un URL base dell’API.

   La chiave API viene mostrata una sola volta. Copiala adesso.

   

   Computer

4. Crea il collegamento nel tuo strumento. Come collegare sullo schermo elenca i passaggi:

   • Zapier: nel tuo Zap, aggiungi un’azione Webhooks by Zapier › POST. Incolla l’URL dell’endpoint e aggiungi la chiave API come indicato sullo schermo. Oppure, in Zapier, cerca “BytePhase” e collegati con la chiave API e l’URL base dell’API.
   • n8n: aggiungi un nodo HTTP Request, clicca su Import cURL e incolla l’esempio curl da Esempi di codice.

   Le sezioni qui sotto mostrano cosa scegliere dentro Zapier e n8n.

5. Fai una prova dal tuo strumento: il passaggio Test di Zapier, oppure esegui il nodo n8n. Poi clicca su Verifica ora in BytePhase.

   Vedi Invio di prova acquisito.

6. Clicca su Avanti in Associa campi e in Se il cliente esiste già, poi clicca su Attiva integrazione.

Fatto!

Ora il tuo Zap o workflow n8n crea lead o check-in autonomi in BytePhase ogni volta che viene eseguito.

Configurare lo Zap in Zapier

1. In Zapier, clicca su Create, poi su Zap.

2. Come trigger, scegli l’app da cui arrivano i dati. Per Google Moduli, scegli New Form Response, non New or Updated Form Response. Altrimenti una risposta modificata crea un secondo lead.

3. Clicca su Test trigger, così Zapier trova una voce recente. Se non trova niente, compila tu una volta il modulo e riprova.

4. Aggiungi un’azione: Webhooks by Zapier, poi POST. Compilala così:

   • URL: l’URL dell’endpoint di BytePhase.
   • Payload Type: Json. Wrap Request In Array: No. Unflatten: Yes.
   • Headers: aggiungi X-API-Key con la tua chiave API. Aggiungi anche Content-Type e Accept, entrambi impostati su application/json.
   • Data: copia la struttura dell’esempio curl da Esempi di codice. I tuoi campi vanno dentro data. Compila ogni valore con il selettore di Zapier invece di scriverlo.

5. Se vuoi, aggiungi un passaggio Filter by Zapier prima dell’azione. Fai passare una voce solo se ha un nome e un’email o un numero di cellulare. Così tieni fuori lo spam.

6. Dopo aver attivato l’integrazione in BytePhase, clicca su Publish in Zapier.

Configurare il workflow in n8n

Import cURL compila per te il nodo HTTP Request. Per compilarlo invece a mano:

1. Imposta Method su POST e URL sull’URL dell’endpoint di BytePhase.

2. Aggiungi due intestazioni: X-API-Key con la tua chiave API, e Content-Type impostato su application/json.

3. Invia il corpo come JSON, con la stessa struttura dell’esempio curl. I tuoi campi vanno dentro data.

4. Se i nomi dei tuoi campi sono diversi da quelli di BytePhase, aggiungi prima un nodo Set. Rinominali con i nomi indicati in Vedi campi disponibili.

Salva la chiave API nelle credenziali di n8n invece di scriverla nel nodo. Così non compare se esporti il workflow.

Cosa può fare l’app BytePhase in Zapier

Quando ti colleghi tramite l’app BytePhase in Zapier, un solo collegamento ti dà:

• Trigger (succede qualcosa in BytePhase): un nuovo lavoro, cliente, lead, pagamento, lavoro esternalizzato, o un cambio di stato di un lavoro.
• Azioni (BytePhase fa qualcosa): creare un cliente, creare un lead o aggiungere un check-in autonomo.
• Ricerca: trovare un cliente.

Buono a sapersi

• Per vedere ogni invio e se è andato a buon fine, usa Vedi attività nella scheda.
• Per l’elenco completo dei campi che BytePhase accetta, clicca su Vedi campi disponibili nel passaggio di collegamento, oppure vedi developers.bytephase.com.
• Se la chiave API viene diffusa, usa Rigenera chiave nella pagina delle attività. Poi aggiorna lo Zap o il workflow con la nuova chiave.
• Se Zapier ripete un passaggio, BytePhase può creare un secondo dato. A evitare i doppioni è la tua scelta in Se il cliente esiste già. In n8n, aggiungi un’intestazione Idempotency-Key con un valore unico per ogni voce, così una ripetizione viene ignorata.