Come migrare da SparkPost a SendGrid

In qualità di pioniere dell'e-mail transazionale basata su cloud, abbiamo assistito a molti cambiamenti e nuove società nello spazio. La tendenza che abbiamo visto con queste aziende è che prima ci imitano, poi ci attaccano, poi ci imitano ancora un po'. Oltre a fornire indicazioni dettagliate sulla migrazione di seguito, vogliamo fornire alcune riflessioni sul valore che i nostri clienti ottengono da SendGrid.

Innanzitutto, tutti i nostri clienti, compresi quelli che utilizzano il nostro piano gratuito, ricevono supporto dal nostro team di supporto di grande esperienza. Per i clienti con il nostro piano gratuito, questo supporto continua anche se non effettuano l'aggiornamento a un piano a pagamento. E per tutti i clienti, il supporto è disponibile 24 ore al giorno, tutti i giorni dell'anno, per ogni regione in cui si trovano i nostri clienti. Le nostre offerte di supporto fanno parte del nostro impegno per garantire il successo a tutti gli utenti della piattaforma SendGrid essendo presenti in qualsiasi momento per loro.

Inoltre, dalle più piccole startup alle più grandi imprese, l'e-mail programmatica basata su API non è l'unico modo in cui queste aziende utilizzano l'e-mail per raggiungere i clienti. Inviano anche newsletter, annunci e campagne per aumentare il coinvolgimento dei clienti e incentivare gli acquisti. In SendGrid, ci dedichiamo a soddisfare tutte le esigenze di comunicazione dei clienti, con l'abilitazione completa del team per il marketing e la promozione, nonché per il programmatic. Il nostro prodotto Campagne di marketing ti consente di coinvolgere i tuoi clienti utilizzando la nostra interfaccia utente intuitiva con segmentazione avanzata, analisi e strumenti di progettazione.

Infine, c'è un motivo per cui abbiamo più di 55.000 clienti paganti che elaborano oltre un miliardo di email al giorno. Il motivo è che utilizziamo la nostra passione per le comunicazioni con i clienti e la nostra profonda esperienza nella posta elettronica per aiutare i nostri clienti a far crescere la loro attività. Ogni giorno lavorano con noi, i nostri clienti sentono la nostra cultura e il nostro impegno per il loro successo.

Come migrare a SendGrid da Sparkpost

Nota: il seguente piano di migrazione è stato fornito per gentile concessione del nostro team di sviluppo della community. Questa procedura evidenzierà alcune differenze tra l'invio di e-mail tramite SparkPost e l'invio di e-mail tramite SendGrid per rendere la migrazione il più semplice possibile.

Se desideri dare un'occhiata in giro prima di iniziare, controlla la documentazione di SendGrid. L'aula è un ottimo posto per iniziare a conoscere l'e-mail prima di immergerti nel riferimento e nei dettagli dell'API.

Terminologia

Se stai cercando l'equivalente SendGrid di alcune funzionalità SparkPost, la tabella seguente ti aiuterà:

Ottenere una chiave API

Per prima cosa avrai bisogno di un account SendGrid. Successivamente, dovresti creare una chiave API che utilizzerai per l'invio. Vai su Impostazioni -> Chiavi API o usa questo link. Una procedura consigliata per SendGrid e sicurezza consiste nell'usare una chiave API diversa per ciascuna delle tue diverse app. Le chiavi API dispongono di autorizzazioni granulari, quindi puoi abilitare o disabilitare l'accesso in lettura o scrittura per i singoli endpoint. Assicurati che la chiave API che crei abbia accesso completo a Mail Send . (Nota: il tuo account deve superare il provisioning prima di poter creare una chiave API.)

Librerie API

Abbiamo una serie di librerie API ufficialmente supportate per facilitare l'integrazione per i nostri clienti. Se stai riscrivendo del codice o rifattorizzando il modo in cui comunichi con il tuo ESP come parte della tua migrazione, ora è un buon momento per valutare queste librerie:

• sendgrid-csharp – Libreria C# ufficiale
• sendgrid-go – Libreria ufficiale di Go
• sendgrid-java – Libreria Java ufficiale
• sendgrid-nodejs – Libreria ufficiale di NodeJS
• sendgrid-php – Libreria PHP ufficiale
• sendgrid-python – Libreria Python ufficiale
• sendgrid-ruby – Libreria ufficiale di Ruby

SMTP

Se stai inviando tramite SMTP, ci sono alcune differenze di cui dovresti essere a conoscenza. Per autenticarti, fornisci la stringa 'apikey' come nome utente SMTP e usa la tua chiave API come password. Quindi punta il tuo nome host su smtp.sendgrid.net .

Puoi connetterti utilizzando SMTP tramite non crittografato o TLS sulle porte 25, 2525 e 587. Puoi anche connetterti tramite SSL sulla porta 465. In generale, consigliamo la porta 587 poiché tende a causare il minor numero di problemi con i provider di hosting.

Il meccanismo per la personalizzazione delle e-mail inviate tramite SMTP è la nostra intestazione X-SMTPAPI. Questa intestazione ti consentirà di definire sostituzioni, inviare richieste di stile di stampa unione in batch e controllare i filtri (come il monitoraggio dei clic) attivi per il tuo invio.

HTTP

L'endpoint principale per l'invio di e-mail è l'endpoint di posta. Le richieste a questo endpoint vengono autenticate tramite un'intestazione di autorizzazione con la chiave API presentata come token di trasporto. Puoi trovare un esempio più dettagliato nei nostri documenti.

Le personalizzazioni consentono di definire destinatari e metadati per ciascun messaggio, ad esempio valori di sostituzione per personalizzare il contenuto o custom_args per associare messaggi a ID utente o numeri di ordine. Sono disponibili numerosi esempi di personalizzazioni per casi d'uso comuni. Puoi anche trovare chiamate di esempio cURL.

Funzionalità come il monitoraggio dei clic sono configurate tramite i parametri tracking_settings e mail_settings. Puoi anche programmare gli invii fino a 72 ore in anticipo utilizzando il parametro "send_at".

Gli allegati inviati tramite HTTP vengono gestiti in modo simile a SparkPost, in cui il contenuto è codificato come Base64 e incorporato direttamente nel payload JSON insieme alle informazioni MIME. Puoi leggere ulteriori informazioni sull'inclusione di allegati nella sezione seguente della nostra aula di documentazione.

Webhook

SendGrid fornisce due webhook: il webhook di eventi per la pubblicazione di eventi in tempo reale e il webhook di analisi in entrata per la ricezione di e-mail e la risposta a livello di codice. Le forme dei dati e i payload sono leggermente diversi da quelli forniti da SparkPost.

Endpoint API non di posta elettronica

Per gli endpoint API che non inviano e-mail, consulta la panoramica dell'API v3. Nella maggior parte dei casi utilizziamo metodi HTTP intuitivi e codici di risposta e applichiamo limiti di velocità per le chiamate. L'API v2 è deprecata, anche se non esiste una sequenza temporale per interrompere il supporto. Tutte le nuove integrazioni dovrebbero preferire la v3. L'autenticazione API v3 viene eseguita da un'intestazione di autenticazione con un token Bearer.

Campagne di marketing

Abbiamo una piattaforma completa per la gestione degli elenchi di contatti, la creazione e la progettazione di modelli, il test A/B di diversi modelli e la pianificazione delle campagne. Tutto questo è racchiuso in un'interfaccia utente facile da usare per i non sviluppatori. E, naturalmente, puoi anche accedere a tutte queste funzionalità tramite la nostra API per le campagne di marketing.

Alcune FAQ

D: Supportate i modelli per le email transazionali?

A: Sì, e sono dinamici! I modelli transazionali di SendGrid presentano il supporto nativo per la sintassi Handlebars. Oltre alla sostituzione e alle sostituzioni di base, puoi utilizzare enumerazioni/iterare su elenchi, sfruttare condizionali e altro ancora. Per saperne di più, clicca qui.

D: Esiste una sandbox o un modo per testare le mie e-mail senza inviarle?

R: Puoi abilitare la modalità sandbox durante l'invio tramite HTTP. C'è anche un indirizzo "sink" che puoi usare per i test.

D: È possibile trasferire il mio indirizzo IP/reputazione mittente a SendGrid?

R: Non possiamo migrare un IP o una reputazione, ma possiamo aiutarti a riscaldare automaticamente un nuovo IP per te.

D: SendGrid supporta il TLS imposto ?

R: Assolutamente. È possibile richiedere che i server di ricezione supportino TLS e che i messaggi vengano inviati a server non conformi.

D: Posso consentire ai miei destinatari di definire i tipi di e-mail che desiderano ricevere?

R: Sì. Dare ai tuoi destinatari un maggiore controllo sulla loro e-mail ti consente di inviare e-mail che le persone desiderano, il che è meglio per tutti. Dai un'occhiata ai gruppi di annullamento dell'iscrizione per ulteriori informazioni.

Se sei interessato a migrare a SendGrid, puoi trovare maggiori informazioni su sendgrid.com/pricing.