Mailen via de SMTP2GO-api

Toegevoegd op donderdag 15 december 2022 10:30 | Laatst gewijzigd op dinsdag 20 december 2022 21:00
103

In dit artikel leggen we je uit hoe je ervoor zorgt dat Neoforce e-mails gaat verzenden via de API van SMTP2GO. Dit betekent dat je een koppeling legt tussen Neoforce en SMTP2GO middels webhooks.

Wat heb je nodig?

Het is van belang dat je beschikt over een acount en een API-key van SMTP2GO. Je kunt tot 1.000 e-mails per maand gratis gebruik maken van SMTP2GO.

We raden aan dat je mailt vanuit servers in Europa.

Aan de slag

Zodra je de API-key hebt verkregen kun je Neoforce koppelen aan de API van SMTP2GO.

Let op: je dient te beschikken over voldoende rechten om dit in te stellen.

  1. Klik rechtsboven op je naam en kies voor 'Beheer'.
  2. Ga in het linkermenu naar 'Triggers & Acties'.
  3. Klik op de knop [Nieuw] om een nieuwe actie te maken.
  4. Vul een naam en omschrijving in. Kies daarna aan de rechterzijde voor het outputtype 'Webhook'.
  5. Vul bij het veld 'URL' het volgende in: https://api.smtp2go.com/v3/email/send.
  6. Vul een timeout in van minimaal 1000. Mocht blijken dat e-mails niet worden afgeleverd kun je dit later verhogen.
  7. Kies als Method voor POST.
  8. Maak een nieuwe Header en vul bij sleutel het volgende in: content-Type en als waarde: application/json.
  9. Kopieer de onderstaande body en pas aan naar wens. Plak het eindresultaat daarna in het veld body:
{
   "api_key" : "[PLAATS_HIER_JE_API_KEY]",
     "to" : [
        "${ticket.caller.displayName} <${ticket.caller.email}>"
    ],
     "sender" : "Support <jouw-email@jouw-domein.nl>",
     "subject" : "${ticket.ticketnr} afgerond!",
     "text_body" : "Beste ${ticket.caller.firstName},\n Je ticket is zojuist afgerond.",
     "html_body" : "Beste ${ticket.caller.firstName},\n Je ticket is zojuist afgerond."
}
  1. Koppel de nieuwe actie aan triggers en klik daarna op [Opslaan].

Als alles goed is ingesteld (zie ook het systeemlogboek), zullen je mails nu via de API van SMTP2GO worden verzonden. Je kunt de normale manier van mailen (de mail-acties) uitschakelen.

Tickets
In dit voorbeeld hebben we gebruik gemaakt van tickets. De mail werd ook gestuurd met data uit een ticket. Het staat je vrij om deze mails ook vanuit andere Neoforce-pagina's te verzenden.

Documentatie
Meer documentatie over de API van SMTP2GO vind je via deze link:
https://apidoc.smtp2go.com/documentation/#/POST%20/email/send

Inhoudsopgave