Come migrare da Dyn Email Delivery a SendGrid

Con la recente notizia che Dyn è stata acquisita da Oracle per la sua attività di gestione DNS, le persone sono state alla ricerca di soluzioni completamente incentrate sull'e-mail. Il nostro team ha avuto un aumento del numero di domande su come migrare dalla consegna e-mail Dyn a SendGrid, quindi abbiamo deciso di mettere insieme questa guida.

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.

Siamo stati un'azienda API-first, solo e-mail sin dal nostro inizio e lo troverai riflesso nei nostri prodotti. Il nostro endpoint e-mail HTTP, webhook, SMTP e API non e-mail sono fondamentali per la nostra attività e vedrai che si riflette nelle loro capacità. Questa guida mirerà a fornirti le nozioni di base su come configurare SendGrid evidenziando le funzionalità utili che mancano al tuo attuale provider.

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

Mentre Dyn fornisce SDK ufficiali in Python e PHP, sette librerie API ufficialmente supportate per semplificare 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. Innanzitutto, non devi preoccuparti di utilizzare un server SMTP specifico in base alla dimensione del tuo messaggio come richiesto da Dyn. Accettiamo anche messaggi fino a ~19,5 MB rispetto al limite di 10 MB di Dyn. 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 .

Offriamo anche opzioni di porte aggiuntive rispetto a Dyn. 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 chiave/valore, inviare richieste di stile di stampa unione in batch e controllare i filtri (come il monitoraggio dei clic) attivi per il tuo invio. Puoi raggruppare le email per categoria o tenere traccia dei metadati per email con unique_args. Si tratta di potenti funzionalità che possono ridurre il tempo di invio e la quantità di larghezza di banda necessaria per le transazioni e-mail e vale la pena esplorarle.

HTTP

L'endpoint principale per l'invio di e-mail è l'endpoint di posta/invio. 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.

Rispetto all'API HTTP di Dyn, il nostro endpoint offre più funzionalità per consentirti di personalizzare e gestire i tuoi destinatari e persino inviare diversi messaggi in un'unica richiesta.

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".

Semplifichiamo anche l'aggiunta di allegati alla tua richiesta API. Basta codificare il file come stringa Base64 e incorporarlo direttamente nel payload JSON insieme alle informazioni sul contenuto 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 di posta elettronica in tempo reale come annullamenti di iscrizioni, rimbalzi, ecc. e il webhook di analisi in entrata per la ricezione di e-mail e la risposta a livello di codice.

Queste funzionalità non sono disponibili su Dyn, ma possono essere ottime per aggiungere ulteriore automazione alla gestione della posta elettronica. Vale la pena dare un'occhiata mentre inizi a configurare.

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

Un'altra caratteristica che offriamo è una solida piattaforma per le campagne di marketing, che ti consente di gestire i tuoi elenchi, creare segmenti dinamici, caricare le tue risorse e progettare il tuo modello di email con un editor visivo, eseguire test A/B automatici e altro ancora. E ovviamente c'è anche un'API aperta dietro tutte queste funzionalità.

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.