In questa pagina
Invia due volte lo stesso contatto di prova. Se la seconda esecuzione crea un altro record o riattiva una disiscrizione, il connettore ha già fallito prima ancora di affrontare il volume.
“Dobbiamo solo collegare le due app.” È un punto di partenza ragionevole. Manca un dettaglio: cosa ricorda il collegamento dopo la prima richiesta?
Controlla tre aspetti prima di scegliere il software
Il trasporto porta richieste o eventi da un sistema all’altro. La mappatura stabilisce il significato dei campi. Lo stato registra quale versione dell’origine è stata elaborata, cosa è fallito e quale record di destinazione le corrisponde.
Definisci un’origine, una destinazione e i campi necessari al primo risultato utile. Assegna una responsabilità per ogni campo. Il sistema commerciale può gestire la fase del ciclo di vita, mentre Brevo gestisce la disiscrizione email attuale. Non serve un unico responsabile per tutti i campi di un record.
Quattro percorsi verso Brevo
Un’app nativa
Cerca nel marketplace Brevo un’app mantenuta e controlla chi la pubblica. Leggi le istruzioni relative ai campi e agli eventi che ti servono davvero. Una presenza nel marketplace non dimostra un’integrazione Tajo.
Per Shopify, parti dal percorso documentato di configurazione e migrazione Brevo PushOwl. Prova la mappatura prima di costruire un secondo collegamento. Un’app nativa può coprire tutto il lavoro, ma campi supportati e controlli di ripristino dipendono da quell’app.
Un servizio di automazione
Un servizio di automazione può ricevere un modulo, mappare i campi e chiamare Brevo. Prima di sceglierlo verifica controlli di ripetizione, costo delle operazioni e archiviazione. Né un volume ridotto né un editor visuale rendono accettabile la perdita di un’iscrizione.
Per i moduli sul sito, la guida Webflow distingue un modulo Brevo incorporato da un modulo nativo elaborato sul server. Scegli il percorso che conserva il comportamento di invio e conferma richiesto.
Un livello d’integrazione
Un livello dedicato ha senso quando più mappature, registri persistenti o un ripristino coordinato giustificano un altro servizio. Chiedi di vedere i record falliti e la ripetizione di un singolo record rifiutato. Non dedurre queste funzioni dal nome della categoria.
Tajo è in accesso anticipato. Porta origine, destinazione e criterio di accettazione a una revisione dell’integrazione. Verifica il connettore e il percorso di esecuzione disponibili prima di farci affidamento. La documentazione di un abbinamento è un punto di partenza per la verifica, non la prova che sia pronto nel tuo spazio.
Codice API diretto
Scegli il codice quando devi controllare identità, trasformazioni o ripristino in un modo che i percorsi disponibili non consentono. A quel punto gestisci tu credenziali, limiti, stato salvato e procedure operative.
La guida all’API Brevo mostra una scrittura di contatto e i relativi errori. Se l’origine è un foglio di calcolo, l’esempio Apps Script è un percorso distinto: non richiede un connettore nativo Tajo per Sheets.
Usa il quadro decisionale
| Decisione | App nativa | Servizio di automazione | Livello d’integrazione | API diretta |
|---|---|---|---|---|
| Campi richiesti | Verifica la mappatura dell’app | Controlla gli input delle azioni | Esamina la proposta | Implementa la mappatura |
| Identità dei record | Verifica le regole di abbinamento | Configura l’abbinamento esplicito | Rivedi il contratto d’identità | Conserva l’ID di destinazione |
| Ripristino | Controlla le funzioni dell’app | Verifica tentativi e ripetizione | Dimostra il ripristino per record | Costruiscilo e gestiscilo |
| Volume e limiti | Conferma i limiti del fornitore | Stima operazioni e limiti | Verifica il carico previsto | Rispetta i limiti di destinazione |
| Responsabilità operativa | Fornitore dell’app e operatore | Responsabile dello scenario | Fornitore e responsabile della sincronizzazione | Il tuo team |
Quale percorso copre il tuo requisito concreto?
-
L’app nativa copre campi e controlli
Usa l’app nativa
Parti dalla configurazione documentata.
-
Un modulo o evento richiede una piccola azione mappata
Valuta un servizio di automazione
Verifica conferma e ripetizione.
-
Più mappature richiedono un ripristino coordinato
Valuta un livello d’integrazione
Chiedi una prova di errore e ripetizione.
-
La trasformazione richiesta non è supportata
Scrivi il percorso API minimo
Prevedi anche i costi di gestione.
Dimostra la prima sincronizzazione con un record
Usa una destinazione isolata e un contatto che controlli. Tieni disattivate le automazioni delle campagne mentre verifichi il percorso dei dati.
- Registra ID di origine, lista di destinazione, attributi richiesti e prove attuali del consenso. Crea i tipi di attributi prima della scrittura.
- Esegui una volta. Controlla il record di destinazione, non solo lo stato del lavoro. Verifica separatamente valori e idoneità al marketing.
- Ripeti la stessa versione dell’origine. Deve esserci una sola identità, senza un’altra conferma o un altro messaggio di benvenuto.
- Modifica un campo ordinario e sincronizza. Poi lascia un campo vuoto e verifica la regola documentata di conservazione o cancellazione.
- Registra una disiscrizione successiva. Rielabora la vecchia iscrizione e verifica che prevalga la disiscrizione.
- Simula una richiesta rifiutata. Conserva identità ed esito, recupera quel record e controllalo prima di avanzare il cursore salvato.
Questa è una procedura di accettazione, non l’affermazione che tutti i connettori offrano gli stessi controlli. Se non puoi dimostrare una verifica necessaria, hai individuato la lacuna da risolvere.
Evita che i nuovi tentativi cambino il significato
L’endpoint dei contatti Brevo accetta ext_id e supporta updateEnabled. L’abbinamento resta una tua responsabilità. Le identità in conflitto vanno riviste; forceMerge può eliminare un record e non deve essere il ripristino predefinito.
Ripetere dati e ripetere effetti collaterali sono problemi diversi. Un contatto può esistere una sola volta ma ricevere due conferme. Salva l’identificativo dell’invio del modulo e l’esito di ogni effetto. Un timeout lascia un esito incerto: controlla la destinazione prima di ripetere un invio.
Leggi la tabella attuale dei limiti per ogni endpoint e livello dell’account. Alcuni percorsi hanno limiti sia orari sia al secondo. Non applicare lo stesso tetto numerico a ogni operazione.
Anche i webhook richiedono un responsabile
Un evento segnala una modifica. Non risolve la responsabilità dei campi né mantiene da solo una sincronizzazione bidirezionale completa.
Autentica la consegna con il metodo supportato dal fornitore, salva il lavoro valido e riconcilia gli aggiornamenti mancanti. Se il connettore riceve indietro il proprio aggiornamento, confronta versione dell’origine registrata e valori previsti prima di scrivere ancora. Non presumere che ogni fornitore restituisca un indicatore di origine personalizzato.
Per un nuovo iscritto, segui la guida al double opt-in prima di includere l’indirizzo nel pubblico marketing. Un indirizzo copiato è un risultato sui dati. Un indirizzo confermato e attualmente iscritto è un risultato diverso.
Il collegamento è pronto quando la seconda esecuzione è spiegabile quanto la prima.
Domande frequenti
Cos’è un connettore Brevo?
Trasferisce dati tra Brevo e un altro sistema. Valuta trasporto, mappatura dei campi e stato di elaborazione salvato, compresa la gestione di identità, errori e consenso.
Da quale integrazione Brevo dovrei partire?
Parti da un’app nativa mantenuta se copre il tuo compito. Scegli un servizio di automazione, un livello d’integrazione o codice API quando un requisito concreto di mappatura o ripristino lo richiede.
Una voce nel marketplace Brevo significa che Tajo supporta l’integrazione?
No. Verifica separatamente chi pubblica l’app e quale flusso è supportato. Una scheda del fornitore, una pagina di documentazione e un connettore Tajo funzionante sono prove diverse.
Come evito contatti duplicati?
Scegli un identificativo stabile di origine, conserva l’ID di destinazione dopo l’abbinamento e risolvi identità in conflitto prima di scrivere. Non usare forceMerge come impostazione ordinaria dei nuovi tentativi.
Cosa deve succedere quando Brevo restituisce 429?
Attendi in base agli header dei limiti applicabili, conserva il lavoro fallito e riprova entro limiti definiti. Registra gli esiti per record senza ripetere effetti collaterali estranei.
Posso sincronizzare il consenso in entrambe le direzioni?
Definisci una fonte autorevole per ogni canale e finalità. Una vecchia iscrizione non deve annullare una successiva disiscrizione. I flussi bidirezionali richiedono regole esplicite per conflitti e prevenzione dei cicli.