Primers passos amb l'API transaccional

L'API transaccional de Flexmail us permet enviar correus electrònics desencadenats, d'un a un, des de la vostra aplicació: confirmacions de comandes, restabliments de contrasenyes, factures i qualsevol altre que es dispari en resposta a una acció específica de l'usuari. Podeu enviar a través de HTTP (API REST) o SMTP, usant el mateix compte i credencials per a tots dos.

El producte transaccional funciona de manera independent del producte de màrqueting de Flexmail. Podeu usar-lo sol sense configurar campanyes ni llistes de contactes.

Atenció L'API transaccional tan sols admet un destinatari per missatge. No es pot usar per a enviaments massius o de màrqueting. Vegeu "Correu electrònic de màrqueting vs. correu electrònic transaccional" per a l'explicació completa.

Requisits previs

• Un compte de Flexmail. El necessiteu per usar l'API transaccional, fins i tot si tan sols envieu correus electrònics transaccionals i no useu les funcionalitats de màrqueting.
• Accés a la configuració DNS del vostre domini per configurar l'autenticació del correu electrònic.
• Accés de desenvolupador a la vostra aplicació o sistema d'enviament per integrar l'API o configurar l'SMTP.

Pas 1: Activar el producte transaccional

Si ja teniu un compte de Flexmail, activeu el producte transaccional des del widget del tauler de control. La prova us dóna fins a 1.000 enviaments durant 30 dies sense cost. Podeu actualitzar a una subscripció transaccional de pagament en qualsevol moment durant o après de la prova.

Si encara no teniu un compte, registreu-vos a flexmail.be/en/signup. Les vostres subscripcions de màrqueting i transaccionals es gestionen des del mateix compte.

Atenció No necessiteu una subscripció de màrqueting per usar el producte transaccional. Si tan sols voleu enviar correus electrònics transaccionals, podeu activar el producte transaccional i deixar les funcionalitats de màrqueting sense usar.

Pas 2: Verificar l'adreça de remitent

Abans de poder enviar, heu de verificar l'adreça de correu electrònic que usareu al camp De.

1. Aneu a Configuració, després a Afegir o eliminar remitents.
2. Afegiu l'adreça de correu electrònic des de la qual voleu enviar.
3. Flexmail envia un correu electrònic de verificació a aquella adreça; feu clic en l'enllaç per confirmar. Això demostra que sou propietaris de la bústia des de la qual envieu.

Pas 3: Configurar l'autenticació del correu electrònic

Configureu SPF, DKIM, DMARC i un return-path personalitzat per al domini de la vostra adreça de remitent. Aquests registres DNS demostren que els vostres correus electrònics genuïnament provenen de vosaltres, que és com els proveïdors de bústia com Gmail decideixen si lliurar el correu electrònic a la bústia d'entrada o rebutjar-lo.

Les instruccions detallades de configuració DNS es troben a la documentació de l'API de correu electrònic de Flexmail, a la secció d'autenticació del correu electrònic.

Atenció L'autenticació del correu electrònic no és opcional per al correu electrònic transaccional. Sense registres SPF i DKIM configurats correctament, els vostres correus electrònics transaccionals fallaran les comprovacions d'autenticació als principals proveïdors de bústia i poden ser rebutjats o enviats a l'spam.

Pas 4: Crear un token d'accés personal

L'API transaccional usa l'autenticació HTTP bàsica. L'ID del compte és el nom d'usuari; un token d'accés personal és la contrasenya. Aquestes credencials són tan sols per a l'API HTTP; l'SMTP usa credencials separades proporcionades per Flexmail a petició.

1. Aneu a Configuració, després a API, després a Tokens d'accés personal.
2. Feu clic a Crear nou token i doneu-li un nom descriptiu.
3. Copieu el token i guardeu-lo de manera segura. No es mostrarà de nou.

Pas 5: Triar el mètode d'enviament

Flexmail admet dues maneres d'enviar correu electrònic transaccional. Totes dues usen el mateix ID de compte i el mateix token d'accés personal.

API HTTP

L'API REST us dóna el màxim control. Podeu enviar missatges, gestionar plantilles, gestionar webhooks i recuperar dades de lliurament de manera programàtica. Aquest és l'enfocament recomanat per a integracions i aplicacions personalitzades.

La documentació completa es troba a email-api.flexmail.eu/documentation. La secció Primers passos inclou un exemple de curl que podeu executar immediatament per verificar la configuració.

SMTP

Els enviaments SMTP s'inclouen al producte transaccional sense cost addicional. Feu servir SMTP quan la vostra aplicació o plataforma ja l'admeti, per exemple, un CMS, una plataforma de comerç electrònic o un sistema heredat que envia correu electrònic a través d'un relay SMTP.

Vegeu "Enviaments SMTP per a correus electrònics transaccionals" per a la configuració de connexió i les instruccions de configuració.

Pas 6: Integrar a la vostra aplicació

Amb un enviament de prova exitós confirmat, esteu llestos per integrar l'API a la vostra aplicació. La documentació completa cobreix:

• Enviament de missatges: tots els paràmetres per al punt final d'enviament
• Plantilles: creació i referència de plantilles de correu electrònic reutilitzables. Vegeu "Plantilles transaccionals i personalització" per a una visió general pràctica.
• Webhooks: notificacions d'events en temps real per a enviaments, lliuraments, rebots, obertures i clics. Vegeu "Webhooks transaccionals" per a la configuració i la referència d'events.

Consell de suport Configureu la gestió de webhooks aviat en la integració. Saber quan rebota un correu electrònic transaccional us permet prendre mesures immediatament: marcar l'adreça al vostre sistema, activar una notificació de seguiment o alertar l'equip, en lloc de descobrir un problema de lliurament dies més tard.

Documentació de l'API i suport

La documentació completa de l'API està disponible a email-api.flexmail.eu/documentation.

Si us quedeu encallats en algun punt, l'equip de suport de Flexmail està disponible a support@flexmail.eu. Les preguntes sobre l'API transaccional les gestiona el mateix equip que admet la interfície de màrqueting.

Passos següents

• Vegeu "Correu electrònic de màrqueting vs. correu electrònic transaccional" per entendre quan usar cada tipus.
• Vegeu "Enviaments SMTP per a correus electrònics transaccionals" si voleu enviar via SMTP en lloc de l'API HTTP.
• Vegeu "Plantilles transaccionals i personalització" per configurar plantilles de correu electrònic reutilitzables.
• Vegeu "Webhooks transaccionals" per rebre events de lliurament en temps real.
• Vegeu "Solució de problemes de correu electrònic transaccional" si alguna cosa no funciona com s'esperava.
• Reviseu la documentació completa de l'API a email-api.flexmail.eu/documentation per a tots els paràmetres del punt final.

Articles relacionats

Hi ha molt més que podeu fer a Flexmail

• Quins tipus de missatges s'adapten bé a Flexmail?
• Documentació de l'API de correu electrònic de Flexmail

Voleu informació de fons?

• Quina diferència hi ha entre el correu electrònic de màrqueting i el correu electrònic transaccional?
• Com funcionen els preus de Flexmail?

Inspireu-vos!

• Què són els correus electrònics transaccionals? Una explicació completa