Come migrare dall'API transazionale di Mailchimp a SendGrid

Nel 2016, Mandrill, ora noto come Mailchimp Transactional API, è diventato un servizio aggiuntivo esclusivo di Mailchimp. Ciò significava che solo i membri mensili di Mailchimp potevano accedere alle funzionalità di transazione e-mail di Mandrill. Per gli altri utenti, hanno dovuto scegliere un'altra piattaforma o scegliere di pagare per un account Mailchimp di cui non avrebbero sempre avuto bisogno.

Abbiamo quindi capito che molti clienti avrebbero cercato un provider alternativo in grado di inviare e-mail in modo efficiente. Twilio SendGrid voleva contribuire a rendere questo processo il più agevole possibile.

Migrazione dall'API transazionale di Mailchimp a SendGrid

In quanto strettamente un componente aggiuntivo, l'API transazionale di Mailchimp non è configurata per fornire e-mail in modo affidabile alla scala necessaria per la tua attività. Ma qui a Twilio SendGrid, siamo i leader nella consegna di e-mail affidabile e sicura, elaborando oltre 100 miliardi di e-mail al mese per i nostri principali mittenti, tra cui Uber, Airbnb e Spotify.

In questo tutorial, illustreremo i principali vantaggi che puoi aspettarti quando invii e-mail con Twilio SendGrid. La nostra guida passo passo alla migrazione garantirà una transizione fluida e snella.

La documentazione Twilio SendGrid è la migliore risorsa per coloro che cercano una risposta a tutte le richieste relative a SMTP, API ed e-mail. È un ottimo punto di partenza prima di immergerti nei dettagli più importanti dello spostamento della posta e delle chiamate API.

Ma prima, se stai cercando l'equivalente Twilio SendGrid di alcune funzionalità dell'API transazionale di Mailchimp, la tabella seguente può aiutarti:

Ottenere una chiave API

Per iniziare, hai bisogno di un account Twilio SendGrid. Quindi, ti consigliamo di creare una chiave API che utilizzerai per l'invio. Vai su Impostazioni → Chiavi API o usa questo link se hai effettuato l'accesso al tuo account. È una saggia pratica di sicurezza utilizzare una chiave API diversa per ciascuna delle tue diverse app. Puoi anche definire le autorizzazioni per le chiavi API abilitando o disabilitando l'accesso in lettura o scrittura per i singoli endpoint. Per ora, ti servirà solo uno che abbia pieno accesso a Mail Send. (Nota: devi passare il provisioning prima di poter creare una chiave API.)

Librerie API

Abbiamo una serie di librerie API ufficialmente supportate che ottimizzano ulteriormente il processo di invio delle email. Se stai riscrivendo qualsiasi codice o riformulando il modo in cui comunichi con il tuo provider di servizi di posta elettronica (ESP) come parte della migrazione, ora è un buon momento per utilizzare una di queste librerie per accelerare la tua integrazione:

• sendgrid-csharp – Libreria ufficiale C#
• sendgrid-go – Libreria ufficiale di Go
• sendgrid-java – Libreria ufficiale di Java
• sendgrid-nodejs – Libreria ufficiale di Node.js
• sendgrid-perl – Libreria Perl ufficiale
• sendgrid-php – Libreria PHP ufficiale
• sendgrid-python – Libreria Python ufficiale
• sendgrid-ruby – Libreria ufficiale di Ruby
• ti.sendgrid – Wrapper ufficiale in Titanio

SMTP

Se non stai utilizzando una delle nostre librerie e invii tramite Simple Mail Transfer Protocol o SMTP, ci sono alcune differenze che dovresti conoscere. Per eseguire l'autenticazione durante l'invio tramite SMTP, fornire la stringa "apikey" come nome utente SMTP e utilizzare la 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. Oppure 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 email è l' endpoint mail.send . Puoi autenticare le richieste a questo endpoint tramite un'intestazione di autorizzazione con la tua chiave API presentata come token Bearer. Trova 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. Esistono diversi esempi di personalizzazioni per casi d'uso comuni. Puoi anche trovare chiamate di esempio cURL .

Funzionalità, come il monitoraggio dei clic, possono essere configurate tramite i parametri tracking_settings e mail_settings .

Per gli allegati inviati tramite HTTP, gestiscili in modo simile all'API transazionale Mailchimp, in cui il contenuto è codificato come Base64 e incorporato direttamente nel payload JSON insieme alle estensioni di posta Internet multiuso o alle informazioni MIME, in questo modo .

Si noti che l'endpoint mail.send di Twilio SendGrid è completamente asincrono. Accetteremo la richiesta, purché sia ​​ben formata, e tenteremo di elaborare la consegna della posta il prima possibile. L'API transazionale di Mailchimp consente l'esecuzione sincrona delle richieste di meno di 10 e-mail. Twilio SendGrid, tuttavia, non offre la modalità sincrona.

Puoi anche programmare gli invii fino a 72 ore in anticipo utilizzando il parametro "send_at".

Webhook

Twilio SendGrid fornisce due webhook: il webhook di eventi per la pubblicazione di eventi in tempo reale e il webhook di analisi delle e-mail in entrata per ricevere e-mail e rispondere ad esse in modo programmatico. Le forme dei dati e i carichi utili sono leggermente diversi da quelli offerti dall'API transazionale di Mailchimp: Twilio SendGrid non ha un equivalente del webhook "sincronizzazione".

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 frequenza per le chiamate. Nonostante non ci siano tempistiche per smettere di supportarlo, l'API v2 è ancora disponibile in minima parte. Tutte le nuove integrazioni, tuttavia, dovrebbero orientarsi verso la v3. L'autenticazione API v3 è accessibile tramite un'intestazione di autenticazione con un token Bearer .

Migrazione alle domande frequenti su Twilio SendGrid

D: Supportate i modelli per le email transazionali?

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

D: Posso testare le mie e-mail senza doverle inviare?

R: Puoi abilitare la modalità sandbox quando invii e-mail tramite HTTP. C'è anche un indirizzo "sink" che puoi usare a scopo di test.

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

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

D: Twilio SendGrid supporta TLS forzato?

R: Assolutamente. I nostri server di ricezione supportano TLS e rilasciano i messaggi in uscita 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 ti consente di inviare e-mail agli abbonati che le desiderano sinceramente, il che è meglio per tutti a lungo termine. Dai un'occhiata ai nostri gruppi di annullamento dell'iscrizione per ulteriori informazioni.

D: Puoi inviare e-mail a più destinatari per richiesta?

R: Sì. I clienti API v3 che utilizzano le personalizzazioni possono includere fino a 1.000 destinatari per richiesta. Gli utenti SMTP possono includere fino a 10.000 destinatari per messaggio, ma spesso consigliamo di utilizzare 1.000 destinatari per richiesta.

Ulteriori informazioni sul passaggio dall'API transazionale Mailchimp a Twilio SendGrid