Dit document beschrijft algemene manieren waarop onze klanten Bird gebruiken voor algemene integratie. Deze integraties behandelen essentiële onderwerpen zoals “hoe verstuur ik e-mail?” en “hoe weet ik wat er met de e-mail is gebeurd?” 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 beschikt over een bestaande SparkPost-account.

Hoe verstuur ik e-mail?

Bird accepteert mail voor overdracht op een paar manieren. Veruit de meest voorkomende is SMTP (Simple Mail Transfer Protocol) en Bird presenteert zich precies als elke andere veilige e-mailagent op poort 587. Als u momenteel generatie- of samenvoegsoftware heeft die een e-mail aanmaakt voor aflevering, zal Bird het accepteren als een standaard SMTP-bericht en proberen het te bezorgen. U heeft een systeem nodig met een geldig TLS-certificaat dat SMTP-berichten kan genereren en deze kan verzenden via poort 587. Postfix, Sendmail en Exim beschikken allemaal over deze capaciteit van nature.

Voorbeeld 1:

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

Voorbeeld 2:

U heeft enige beheercode die de lokale server's “Mail” functie moet gebruiken.
· Als u Sendmail gebruikt, bewerk dan het /etc/mail/sendmail.mc bestand om een “smart-host” definitie toe te voegen.
BIJVOORBEELD: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· Als u Postfix gebruikt, bewerk dan het /etc/postfix/transport bestand om een smtp-relaydefinitie toe te voegen.
BIJVOORBEELD: * smtp:MyMessageBirdServer.com
· Zorg ervoor dat u TLS inschakelt en stel uw uitgaande poort in op 587.
· Pas de wijzigingen toe en start de lokale mailservices opnieuw
· Voer de beheercode uit en de mail zal voor bezorging naar MessageBird worden geleid

En wat betreft REST-injectie?

Voor klanten die HTTP(S) gebruiken om gegevens binnen hun netwerken te transporteren, kan het omslachtig zijn een bericht om te zetten naar SMTP. Bird heeft een uitgebreide REST API die een JSON-sjabloon, lijst van ontvangers, en substitutiegegevens via HTTPS kan accepteren en deze vervolgens kan omzetten in gegenereerde (samengevoegde) e-mails om over standaard SMTP naar de wereld te worden verzonden. Dit is bijzonder nuttig om het generatieproces van webservers naar de mailengine te verplaatsen.

Voorbeeld:

Uw servers genereren dagelijks een nieuwsbrief naar 50.000 ontvangers door persoonlijke gegevens samen te voegen en deze vervolgens afzonderlijk te verzenden via Postfix.
· Maak JSON-objecten voor de ontvangers, substitutiegegevens en inhoudsjabloon.
· Gebruik de REST API om de JSON-objecten te POSTEN naar de Bird Transmission API. Hiermee verplaatst u het generatieproces naar SparkPost 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 overvloedige hoeveelheden leveringsinformatie en stelt deze beschikbaar aan u in JSON-formaat die kan worden “gepusht” als een webhook of “gepulled” met een API-aanroep. 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 gegevens dan u 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 om te zetten naar een Postfix-logboekindeling indien nodig. Levering, bounce, afwijzing, spam_klacht, open, klik en vertraging gegevens kunnen op dezelfde manier worden gelezen.

Voorbeelden:

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

2) U vindt het leuk om uw Postfix-logboeken om te zetten naar JSON en ze vervolgens in een webservice te trekken voor het lezen en analyseren.
A) Gebruik de MessageBird metrics API om SparkPost te poll voor de gegevens die u nodig heeft, en deze wordt automatisch geëxporteerd als JSON

3) U heeft een apart proces dat de logs in realtime volgt en parseert en een aparte ontvangerdatabase bijwerkt.
A) SparkPost kan een realtime webhook bieden die uw proces kan voorzien van spam_klachtgegevens en uitschrijvingen specifiek voor dit doel. Implementatie is triviaal.

-Tom