Ξεκινήστε να στέλνετε το δικό σας email με αυτό το φιλικό API και την ελάχιστη ρύθμιση.

Στον σύγχρονο ψηφιακό κόσμο με γρήγορους ρυθμούς, το μάρκετινγκ μέσω email είναι ένα απαραίτητο εργαλείο για τις επιχειρήσεις ώστε να προσεγγίσουν αποτελεσματικά τους πελάτες τους. Ωστόσο, η εφαρμογή ενός συστήματος email μπορεί να είναι μια πολύπλοκη και χρονοβόρα διαδικασία, ειδικά για προγραμματιστές που είναι νέοι στην εργασία.

Ευτυχώς, με το Sendinblue, η αποστολή email είναι μια πολύ εύκολη δουλειά. Ως πλατφόρμα λογισμικού ως υπηρεσίας (SaaS), το Sendinblue παρέχει όλα όσα χρειάζεστε ως ιδιοκτήτης επιχείρησης ή προγραμματιστής για να μεταφέρετε τα email σας στους χρήστες σας πολύ εύκολα.

Τι είναι το Sendinblue;

Το SendinBlue είναι μια πλατφόρμα λογισμικού ως υπηρεσία (SaaS) που προσφέρει μια εύχρηστη λύση μάρκετινγκ ηλεκτρονικού ταχυδρομείου για μικρές, μεσαίες και μεγάλες επιχειρήσεις. Το SendinBlue παρέχει μια πλατφόρμα που βοηθά τις εταιρείες να αναπτύξουν τις σχέσεις τους με τους πελάτες τους, κυρίως μέσω υπηρεσιών email και SMS.

instagram viewer

Το SendinBlue προσφέρει επίσης API και εργαλεία που επιτρέπουν στους προγραμματιστές να αυτοματοποιούν και να στέλνουν email και SMS. Αυτά τα εργαλεία είναι εύκολο να ενσωματωθούν με το Node.js και άλλες γλώσσες προγραμματισμού για τη δημιουργία προσαρμοσμένων καμπανιών email και SMS.

Με το SendinBlue, οι επιχειρήσεις μπορούν να απλοποιήσουν τις διαδικασίες επικοινωνίας και να προσεγγίσουν χρήστες ή πελάτες πιο αποτελεσματικά.

Πώς να αποκτήσετε διαπιστευτήρια API του SendinBlue

Για να χρησιμοποιήσετε τα API και τα SDK του SendinBlue, η πρώτη προϋπόθεση είναι ένας λογαριασμός SendinBlue. Το SendinBlue παρέχει μια εύκολη διαδικασία εγγραφής και μπορείτε να δημιουργήσετε έναν λογαριασμό στο Σελίδα εγγραφής SendinBlue.

Δημιουργήστε έναν λογαριασμό, εισαγάγετε τα απαιτούμενα στοιχεία και επιλέξτε ένα κατάλληλο πρόγραμμα στη διαδικασία ενσωμάτωσης. Στη συνέχεια, το SendinBlue θα σας ανακατευθύνει στον πίνακα ελέγχου, όπου θα μπορείτε να λάβετε τα διαπιστευτήριά σας API.

Για να αποκτήσετε τα διαπιστευτήριά σας API, ακολουθήστε τα παρακάτω βήματα.

  1. Κάντε κλικ στο όνομα του οργανισμού σας στην επάνω δεξιά γωνία του πίνακα ελέγχου.
  2. Επιλέγω SMTP & API από το αναπτυσσόμενο μενού.
  3. Εναλλαγή στο Κλειδιά API καρτέλα και κάντε κλικ στοΔημιουργήστε ένα νέο κλειδί API κουμπί.
  4. Στο αναδυόμενο παράθυρο που εμφανίζεται, δώστε στο κλειδί σας ένα όνομα, αντιγράψτε τη συμβολοσειρά που δημιουργήθηκε και, στη συνέχεια, αποθηκεύστε την με ασφάλεια.

Αυτή η συμβολοσειρά είναι το κλειδί API και το διαπιστευτήριο ταυτότητάς σας που πρέπει να αποθηκεύσετε προσεκτικά, ώστε να μην πέσει σε λάθος χέρια.

Πώς να δημιουργήσετε ένα σύστημα αποστολής email στο Node.js

Το Node.js δεν έχει α ενσωματωμένο πακέτο email όπως το Golang. Για να στείλετε email, χρειάζεστε ένα εξωτερικό πακέτο όπως nodemailer ή αυτό που παρέχει το SendinBlue.

Θα χρειαστείτε επίσης εργασιακή γνώση του Node.js και ένα περιβάλλον ανάπτυξης Node.js στον υπολογιστή σας.

Σκεφτείτε αυτήν την απλή εφαρμογή Node/Express με α /waitlist τελικό σημείο:

// server.js
συνθ εκφράζω = απαιτώ('εξπρές');
// δημιουργία διακομιστή
συνθ διακομιστής = express();
συνθ λιμάνι = 3333;


server.listen (port, () => {
κονσόλα.κούτσουρο(`Ακρόαση διακομιστή στη θύρα ${port}`);
})


// δημιουργία τελικού σημείου λίστας αναμονής
server.use('/λίστα αναμονής', ασυγχρονισμός (απαιτ., ανταπ.) => {
δοκιμάστε {
συνθ χρήστης = req.body;
κονσόλα.κούτσουρο(`${user.fullname} μπήκε στη λίστα αναμονής».);
 res.status(200).json({ μήνυμα: "Εγγραφή στη λίστα αναμονής με επιτυχία" })
 } σύλληψη (λάθος) {
κονσόλα.error (σφάλμα)
 res.status(500).json({ μήνυμα: 'Παρουσιάστηκε σφάλμα' })
 }
})

Μπορείτε να χρησιμοποιήσετε το SendinBlue για να στείλετε ένα email καλωσορίσματος σε έναν χρήστη που συμμετέχει στη λίστα αναμονής.

Το πρώτο βήμα είναι να εγκαταστήσετε το SDK χρησιμοποιώντας npm ή οποιονδήποτε άλλο διαχειριστή πακέτων. Τρέξιμο npm εγκατάσταση sib-api-v3-sdk ή νήμα προσθήκη sib-api-v3-sdk στον φάκελο του έργου σας για να το προσθέσετε στις εξαρτήσεις του έργου.

Μετά την εγκατάσταση, είστε έτοιμοι να ξεκινήσετε να στέλνετε email με λίγες ακόμη γραμμές κώδικα. Σε ένα μεγαλύτερο έργο, πιθανότατα θα θέλατε να απομονώσετε τη λειτουργία email σε ένα ξεχωριστό αρχείο. Ωστόσο, για αυτήν την επίδειξη, μπορείτε να συνεχίσετε να χρησιμοποιείτε το ίδιο server.js αρχείο.

Εισαγάγετε το sib-api-v3-sdk πακέτο και ρυθμίστε τον πελάτη SendinBlue όπως παρακάτω:

συνθ SibApi = απαιτώ('sib-api-v3-sdk');
// δημιουργία νέου προγράμματος-πελάτη SendinBlue API
συνθ SibClient = SibApi. ApiClient.instance;
// Αυθεντικοποίηση
SibClient.authentications['api-key'].apiKey = διεργασία.env. SIB_API_KEY
 || 'YOUR_API_KEY_HERE';

Στη συνέχεια, ρυθμίστε ορισμένες ρυθμίσεις και δημιουργήστε μια λειτουργία για την αποστολή των email καλωσορίσματος:

συνθ συναλλαγήEmailApi = νέος SibApiSDK.TransactionalEmailsApi();
αφήνω smtpMailData = νέος SibApiSDK.SendSmtpEmail();


συνθ αποστολέας = {
 ΗΛΕΚΤΡΟΝΙΚΗ ΔΙΕΥΘΥΝΣΗ: '[email protected]', // η ηλεκτρονική σου διεύθυνση
 όνομα: "Παράδειγμα αποστολέα",
};
συνθ SendWaitlistEmail = ασυγχρονισμός (userData) => {
}

ο συναλλαγή EmailApiΗ μεταβλητή αποθηκεύει ένα αντικείμενο που σας επιτρέπει να στέλνετε μηνύματα ηλεκτρονικού ταχυδρομείου συναλλαγών (όπως ονομάζονται στο SendinBlue). ο smtpMailData Η μεταβλητή θα αποθηκεύσει τα δεδομένα email συναλλαγής που θα χρειαστείτε για να στείλετε κάθε email: τον παραλήπτη, το περιεχόμενο κ.λπ.

Τώρα στο σώμα του SendWaitlistEmail λειτουργία. Ο παρακάτω κώδικας δείχνει πώς πρέπει να μοιάζει το σώμα της συνάρτησης.

συνθ SendWaitlistEmail = ασυγχρονισμός (userData) => {
δοκιμάστε {
 smtpMailData.sender = αποστολέας;
 smtpMailData.to = [{
 email: userData.email,
 όνομα: userData.fullname
 }];


 smtpMailData.subject = 'Είσαι στη λίστα αναμονής!';


 smtpMailData.params = {
'όνομα': userData.fullname,
'κελάδημα': '@κάνουν χρήση του'
 };


 smtpMailData.htmlΠεριεχόμενο = "
Γεια σας {{ params.name }}, "

 + "Καλώς ήρθατε στη λίστα αναμονής του makeuseof.com. Θα σας ενημερώσουμε"
 + «όταν ξεκινήσουμε. Παρακαλούμε ακολουθήστε μας στο Twitter"
 + "{{ params.twitter }}.
";
// να στείλετε e-mail
αναμένω transactionEmailApi.sendTransacEmail (smtpMailData)
 .έπειτα((δεδομένα) => { 
κονσόλα.log (δεδομένα) // καταγράψτε το αναγνωριστικό email
 })
 .σύλληψη((λάθος) => {
κονσόλα.error (σφάλμα)
βολήνέοςΛάθος(λάθος) // χειρισμός σφαλμάτων
 })
 } σύλληψη (λάθος) {
κονσόλα.κούτσουρο('Προέκυψε ένα σφάλμα...')
κονσόλα.error (σφάλμα)
βολήνέοςΛάθος(λάθος) // χειρισμός σφαλμάτων
 }
}

Το μεγαλύτερο μέρος αυτού του κώδικα συμπληρώνει βασικές ιδιότητες του smtpMailData αντικείμενο. Κατά σειρά, αυτά είναι:

  • αποστολέας: Ένα αντικείμενο που περιέχει δύο ιδιότητες: email και όνομα. Ο παραπάνω κώδικας χρησιμοποιεί μια ψευδή διεύθυνση email, αλλά θα πρέπει να χρησιμοποιήσετε μια πραγματική, λειτουργική διεύθυνση email για εφαρμογές παραγωγής.
  • προς την: Αυτή είναι μια σειρά παραληπτών email. Τα στοιχεία αυτού του πίνακα είναι αντικείμενα που ορίζονται με τα δεδομένα (email και όνομα) του παραλήπτη email. Μπορείτε να έχετε έως και 50 παραλήπτες ανά μήνυμα. Τεχνικά, είναι δυνατό να στείλετε το μήνυμά σας σε περισσότερους από 50 ταυτόχρονα, αλλά αν το κάνετε αυτό αυξάνει τον κίνδυνο οι πράκτορες email να το αντιμετωπίσουν ως ανεπιθύμητο.
  • θέμα: Αυτό είναι το θέμα του email προς αποστολή.
  • παραμέτρους: Αυτά είναι πρόσθετα δεδομένα που μπορείτε να χρησιμοποιήσετε σε διάφορα σημεία του email σας (κυρίως το θέμα και το περιεχόμενο). Μπορείτε να χρησιμοποιήσετε τιμές από αυτό παραμέτρους αντικείμενο εγκλείοντάς τα σε διπλά σγουρά σιδεράκια (δηλ {{ params.name }}).
  • htmlΠεριεχόμενο: Αυτή η ιδιότητα ορίζει το σώμα του μηνύματος. Βοηθά στον καθορισμό του σώματος του μηνύματος του email, το οποίο μπορείτε να μορφοποιήσετε χρησιμοποιώντας HTML. Έχει και εναλλακτική, περιεχόμενο κειμένου, το οποίο διατηρεί το σώμα του μηνύματος απλό.

Το email μπορεί να έχει περισσότερες ιδιότητες και μπορείτε να τις ανακαλύψετε όλες μέσα τεκμηρίωση προγραμματιστή του SendinBlue.

Τέλος, το sendTransacEmail μέθοδος για συναλλαγή EmailApi στέλνει το email και επιστρέφει το αναγνωριστικό του email.

Έχοντας εφαρμόσει το SendWaitlistEmail λειτουργία, μπορείτε να την καλέσετε στο τελικό σημείο της λίστας αναμονής. Το τελικό σημείο της λίστας αναμονής παραπάνω θα μοιάζει τώρα με αυτό:

server.use('/λίστα αναμονής', ασυγχρονισμός (απαιτ., ανταπ.) => {
δοκιμάστε {
συνθ χρήστης = req.body;
κονσόλα.κούτσουρο(`${user.fullname} μπήκε στη λίστα αναμονής».);
// κλήση λειτουργίας αποστολέα email 
αναμένω SendWaitlistEmail (χρήστης)
 res.status(200).json({ μήνυμα: "Εγγραφή στη λίστα αναμονής με επιτυχία" })
 } σύλληψη (λάθος) {
κονσόλα.error (σφάλμα)
 res.status(500).json({ μήνυμα: "Παρουσιάστηκε σφάλμα εσωτερικού διακομιστή" })
 }
})

Μπορείτε να ξεκινήσετε την αίτησή σας και να δοκιμάσετε το τελικό σημείο της λίστας αναμονής σας σε ένα πρόγραμμα-πελάτη REST API ή από το frontend της εφαρμογής σας. Ακολουθεί ένα παράδειγμα αίτησης δοκιμής από τον Postman.

Δείτε πώς φαίνεται το ληφθέν email. Παρατηρήστε ότι οι τιμές από το παραμέτρους αντικείμενο είναι παρόν.

Εάν ελέγξετε το τερματικό σας, θα δείτε επίσης το Αναγνωριστικό μηνύματος τυπωμένο στην κονσόλα. Μπορείτε να αποθηκεύσετε αυτήν την τιμή σε μια βάση δεδομένων ή ένα αρχείο καταγραφής για να προσδιορίσετε ένα συγκεκριμένο email.

Μπορείτε επίσης να εξετάσετε το ενδεχόμενο να ελέγξετε μερικά συμβουλές για να αποτρέψετε τη μετάβαση των email στα ανεπιθύμητα μηνύματα των παραληπτών.

Αν και αυτό το σύστημα ηλεκτρονικού ταχυδρομείου λειτουργεί σωστά, το να καλέσετε το τελικό σημείο απευθείας τη λειτουργία αποστολέα email δεν είναι η πιο αποτελεσματική προσέγγιση. Θα μπορούσε να αναγκάσει την αίτησή σας να περιμένει άσκοπα ενώ στέλνει το email. Για να αποφύγετε αυτό, θα πρέπει να βελτιστοποιήσετε τη διαδικασία κατά υλοποίηση μιας ουράς εργασιών για να χειριστείτε τον φόρτο εργασίας του email.

Η αποστολή email στο Node.js δεν ήταν ποτέ πιο εύκολη

Είναι ικανοποιητικό να συνειδητοποιείς ότι μπορείς να δημιουργήσεις μια υπηρεσία για την αποστολή email στο Node.js πολύ εύκολα.

Πέρα από το πεδίο αυτού του οδηγού, υπάρχουν πολλά περισσότερα που μπορείτε να κάνετε με το SendinBlue. Θα μπορούσατε να στείλετε διαφορετικές εκδόσεις email σε διαφορετικούς παραλήπτες ταυτόχρονα, χρησιμοποιώντας πρότυπα email που παρέχονται από SendinBlue, διαμορφώστε τα webhook για να εντοπίζουν ενέργειες από τους παραλήπτες email σας και να προβάλετε σε πραγματικό χρόνο αναλυτικά στοιχεία.

Μπορείτε να εξερευνήσετε αυτές τις δυνατότητες ελέγχοντας τις στην πύλη προγραμματιστών και εφαρμόζοντάς τις στις εφαρμογές Node.js.