Dit document beschrijft de gebruikelijke manieren waarop onze klanten Bird gebruiken voor algemene integratie. Deze integraties behandelen essentiële onderwerpen zoals "hoe stuur ik een e-mail?" en "hoe weet ik wat er met de e-mail is gebeurd?" Voor organisaties die hybride on-premises en cloudopstellingen met beveiligingseisen onderhouden, behandelt onze S/MIME-implementatiegids voor on-premises-platforms PowerMTA- en Momentum-configuraties voor veilige e-maillevering. Als u overstapt van Postfix, Sendmail of Exim, zou dit document alles moeten uitleggen wat u moet weten over de basisprincipes van het verzenden en rapporteren van e-mail. De rest van dit document gaat ervan uit dat u een bestaand SparkPost-account heeft.

Hoe stuur ik een e-mail?

Bird zal op een paar manieren mail accepteren voor overdracht. Veruit de meest gebruikelijke methode is SMTP (Simple Mail Transfer Protocol) en Bird presenteert zich precies als elke andere veilige e-mailagent op poort 587. Als u momenteel generatiesoftware of samenvoegsoftware heeft die een e-mail voor levering maakt, accepteert Bird deze als een standaard SMTP-bericht en probeert het te leveren. U heeft een systeem nodig met een geldig TLS-certificaat dat SMTP-berichten kan genereren en over poort 587 kan verzenden. Postfix, Sendmail en Exim hebben deze mogelijkheid van nature.

Voorbeeld 1:

U heeft een webserver die een samengevoegd bericht genereert voor e-maillevering via Postfix.
· Pas de generatiesoftware van de webserver aan om het SMTP-bericht naar uw toegewezen SparkPost-server te sturen in plaats van naar de Postfix-server
· Ja, het is echt zo eenvoudig

Voorbeeld 2:

U heeft wat beheercode die de lokale server moet gebruiken om de functie "Mail" uit te voeren.
· Als u Sendmail gebruikt, bewerk het bestand /etc/mail/sendmail.mc om een "smart-host"-definitie toe te voegen.
IBV: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· Als u Postfix gebruikt, bewerk het bestand /etc/postfix/transport om een smtp relaisdefinitie toe te voegen.
IBV: * smtp:MyMessageBirdServer.com
· Zorg ervoor dat u TLS inschakelt en stel uw uitgaande poort in op 587.
· Pas de wijzigingen toe en herstart de lokale maildiensten
· Voer de beheercode uit en de mail zal naar MessageBird worden gerouteerd voor levering

Wat te doen met REST-injectie?

Voor klanten die HTTP(S) gebruiken om gegevens in hun netwerken te transporteren, kan het converteren van een bericht naar SMTP omslachtig zijn. Bird heeft een uitgebreide REST API die een JSON-template, lijst van ontvangers en substitutiegegevens via HTTPS kan accepteren en dit vervolgens kan converteren naar gegenereerde (samengevoegde) e-mail om over te dragen aan de wereld via standaard SMTP. Dit is vooral handig om de generatiearbeid van webservers naar de mail-engine te verplaatsen.

Voorbeeld:

Uw servers genereren dagelijks een nieuwsbrief naar 50.000 ontvangers, waarbij persoonlijke gegevens worden samengevoegd en vervolgens elk afzonderlijk via Postfix worden verzonden.
· Maak JSON-objecten voor de ontvangers, substitutiegegevens en contenttemplate.
· Gebruik de REST API om de JSON-objecten naar Bird's Transmission API te POSTEN. Door dit te doen, wordt het generatieproces naar SparkPost verplaatst voor snellere levering.
· U kunt zelfs de JSON in een bestand plaatsen en cURL gebruiken:

curl -v -H "Content-Type: application/json" -X POST \ https://api.bird.com/api/v1transmissions -d@./newsletter.json

Hoe krijg ik leveringsinformatie?

Bird verzamelt grote hoeveelheden leveringsinformatie en stelt deze beschikbaar voor u in JSON-formaat dat als een webhook kan worden "gepusht" of kan worden "opgehaald" met een API-oproep. De gegevens voor een levering zien er ongeveer zo uit:

{      "campaign_id":"Welcome_Letter",    "customer_id":"108",    "delv_method":"esmtp",    "event_id":"84769964978165188",    "friendly_from":"bounce@sp-send.com",    "ip_address":"50.116.50.117",    "ip_pool":"default",    "message_id":"00046a82565a6d39451a",    "msg_from":"abc-bounces-108@sp-send..com",    "msg_size":"2164",    "num_retries":"0",    "queue_time":"1759",    "raw_rcpt_to":"fakespark+32@deadboltemail.com",    "rcpt_meta":{      },    "rcpt_tags":[      ],    "rcpt_to":"fakespark+32@deadboltemail.com",    "routing_domain":"deadboltemail.com",    "sending_ip":"52.38.47.118",    "subject":"Welcome Letter Template",    "tdate":"2018-01-10T21:15:24.000Z",    "template_id":"welcome-letter",    "template_version":"5",    "transmission_id":"84769964922735103",    "type":"delivery",    "timestamp":"2018-01-10T14:15:24.000-07:00" }

Dat is waarschijnlijk veel meer data dan je gewend bent te zien in een Postfix-logboek en het is al in een formaat dat gemakkelijk te consumeren is. Het is relatief eenvoudig om die JSON-gegevens naar Postfix-logboekformaat te converteren indien nodig. Levering, bounce, afwijzing, spam_klacht, open, klik en vertraging gegevens kunnen op dezelfde manier gelezen worden.

Voorbeelden:

1) U exporteert meestal Postfix-logboeken naar Excel zodat u ze kunt sorteren en analyseren.
A) Voer een message_events API-oproep uit en voer de resulterende JSON-gegevens door JSON2CSV.

2) U houdt ervan uw Postfix-logboeken naar JSON te converteren en deze vervolgens naar een webservice te trekken voor lezen en analyse.
A) Gebruik de MessageBird-metrics API om de benodigde gegevens bij SparkPost op te halen, en het wordt automatisch als JSON geëxporteerd.

3) U heeft een apart proces dat de logboeken in real-time volgt en analyseert en een aparte adressendatabase bijwerkt.
A) SparkPost kan een real-time webhook bieden die uw proces spam_klachten en afmeldingen kan doorgeven speciaal voor dit doel. Implementatie is triviaal.

-Tom