Enviaments SMTP per a correus electrònics transaccionals

A més de l'API HTTP, Flexmail admet l'enviament de correu electrònic transaccional via SMTP. Això és útil quan la vostra aplicació o plataforma ja té suport SMTP integrat: un CMS, una plataforma de comerç electrònic o un sistema heretat que envia correu electrònic a través d'un relay SMTP.

L'enviament SMTP s'inclou al producte transaccional sense cost addicional. Proporciona la mateixa fiabilitat de lliurament i capacitats de seguiment que l'API, amb algunes diferències en els valors predeterminats i les funcionalitats admeses.

Nota

L'enviament SMTP no està habilitat per defecte. Cal que sol·liciteu l'accés explícitament. Vegeu "Sol·licitar accés" a continuació.

Sol·licitar accés

L'accés SMTP no s'habilita automàticament quan activeu el producte transaccional. Per sol·licitar credencials SMTP per al vostre compte, contacteu el suport de Flexmail a support@flexmail.eu i incloeu l'ID del vostre compte a la sol·licitud. El vostre nom d'usuari i contrasenya SMTP es proporcionaran com a part de la resposta de credencials.

Nota

Les vostres credencials SMTP són independents del vostre token d'accés personal. El nom d'usuari i la contrasenya per a SMTP els proporciona Flexmail a petició; no useu l'ID del vostre compte ni el token d'accés personal com a credencials SMTP.

Configuració de la connexió

Un cop s'hagi concedit l'accés SMTP, useu la configuració següent:

Configuració

Valor

Servidor

submission.flexmail.eu

Port

587

Seguretat de la connexió

STARTTLS

Nom d'usuari

Proporcionat per Flexmail a petició

Contrasenya

Proporcionada per Flexmail a petició

Capçaleres personalitzades

Els enviaments SMTP admeten diverses capçaleres personalitzades opcionals que controlen el comportament i el seguiment dels missatges. Aquestes funcionen de manera similar a les opcions disponibles a l'API HTTP.

Capçalera

Descripció

X-Flexmail-Tag

Afegiu una etiqueta per categoritzar els missatges i acumular estadístiques. Ha d'estar en format snake_case (1-50 caràcters, per exemple order_confirmation).

X-Flexmail-Metadata-{key}

Afegiu metadades personalitzades com a parells clau/valor. Substituïu {key} pel nom del vostre camp en snake_case. El valor ha de tenir entre 1 i 80 caràcters.

X-Flexmail-Open-Tracking

Establiu-lo a true per habilitar el seguiment d'obertures. Desactivat per defecte.

X-Flexmail-Link-Tracking

Establiu-lo a true per habilitar el seguiment d'enllaços. Desactivat per defecte.

Exemple:

X-Flexmail-Tag: order_confirmation X-Flexmail-Metadata-order_id: 12345 X-Flexmail-Metadata-customer_id: C-789 X-Flexmail-Open-Tracking: true X-Flexmail-Link-Tracking: true

Nota

El seguiment d'obertures i d'enllaços està desactivat per defecte tant per als enviaments SMTP com per a l'API HTTP. Afegiu les capçaleres corresponents si voleu que el seguiment estigui habilitat.

ID del missatge i correlació de webhooks

La capçalera Message-ID original del vostre correu electrònic enviat s'emmagatzema automàticament com a metadades sota la clau original_message_id. Això us permet correlacionar els events de lliurament dels webhooks amb els missatges que heu enviat des del vostre propi sistema.

SMTP vs. l'API HTTP

Els dos mètodes presenten algunes diferències en els valors predeterminats i les capacitats:

Funcionalitat

API HTTP

Enviament SMTP

Seguiment d'obertures

Desactivat per defecte

Seguiment d'enllaços

Desactivat per defecte

Message-ID original

N/A

Preservat com a metadades original_message_id

Fitxers adjunts en línia

Admès

No admès

Correu electrònic de text pla únicament

Admès

No admès

Funcionalitats admeses

Correus electrònics HTML amb o sense una part de text pla.
Seguiment d'obertures i d'enllaços (via capçaleres personalitzades).
Destinataris en CC i CCO.
Fitxers adjunts: han d'estar codificats en base64. No s'admeten fitxers adjunts en línia.
Limitació de la taxa per destinatari, consistent amb els límits de taxa de l'API.

Requisits

L'adreça De ha de ser un remitent verificat al vostre compte de Flexmail.
El domini d'enviament ha d'estar autenticat amb SPF, DKIM i DMARC, i s'ha de configurar un return-path. Aquests requisits són els mateixos que per a l'API HTTP.

Gestió d'errors

Els errors d'enviament es notifiquen via un NDR (Informe de no lliurament) enviat a l'adreça del remitent del sobre. Els events de rebot i tots els altres events de missatge també estan disponibles a través de l'endpoint de detalls del missatge i els webhooks, de la mateixa manera que els enviaments de l'API.

Passos següents

Vegeu "Primers passos amb l'API transaccional" per al procés complet de configuració del compte.
Vegeu "Webhooks transaccionals" per rebre events de lliurament i seguiment en temps real.
Vegeu "Resolució de problemes transaccionals" si la vostra connexió SMTP o la capacitat de lliurament no funciona com s'esperava.