NL·EN
Contact

Orders & meldingen

Manual notification templates

De Manual Notification Template werkt naadloos samen met automatiseringstools die op onze Public API zijn aangesloten.

Je beheert het onderwerp en de inhoud van je meldingen in oneCORE, en gebruikt tegelijk dynamische gegevens uit externe systemen. Bovendien bepaal je zelf wanneer de meldingen worden verstuurd.

In oneCORE beheer je met de Manual Notification Template alleen de inhoud van het bericht (onderwerp en tekst). De overige gegevens, zoals de e-mailadressen van ontvangers, cc-contacten en andere parameters, geef je mee via de Public API op het moment dat je de melding verstuurt.

Machtigingen

Om manual notification templates te beheren heb je de rol "NotificationTemplates" nodig, en “DynamicNotificationTemplates” om de manual template te kiezen.

Een Manual Notification Template maken

  1. Ga naar Notification templates onder het menu Management.
  2. Klik op “Add notification”.
  3. Vul een “Template name” in.
  4. Kies het mail type “Manual”.
  5. Kies het mail format: Email of SMS.
  6. Kies een “Template”.
  7. Is de manual notification template aangemaakt, vul dan de onderwerpregel en de inhoud in.

Template

De template bepaalt welke dynamische gegevens je in deze notification template kunt gebruiken, zodat alleen relevante gegevens in de inhoud komen. Dynamische gegevens zijn waarden die per ontvanger verschillen, zoals persoonsgegevens en ordernummers.

De gegevens die passen, staan klaar als shortcodes die je in de inhoud van de melding gebruikt.

Zo maak je een template:

Een template maak je alleen via de public API DynamicNotificationTemplates (/api/v2/dynamicnotificationtemplates).

  • Name: de naam van de template
  • Field: de gegevens die passen

Identifier: de shortcode die je in de tekst gebruikt, bij voorkeur in hoofdletters.

Type: het soort gegevens: tekst (0) of getal (1).

Voorbeeldverzoek

{
  "Name": "Order confirmation",
  "Fields": [
    {
      "Identifier": "ORDER_ID",
      "Type": 1
    },
    {
      "Identifier": "SHOP_USER_NAME",
      "Type": 0
    }
  ]
}

Antwoord

{
  "Data": {
    "Id": 1
  }
}

Melding versturen

De Manual Notification Template verstuurt e-mails of sms'jes na een Public API-aanroep van het trigger-endpoint voor notification templates (/api/v2/notificationtemplates/trigger). In het verzoek geef je afzenders, ontvangers en andere gegevens op. Je kunt ook de dynamische gegevens meesturen die bij het versturen de shortcodes in de e-mail of sms vervangen.

Voorbeeldverzoek voor een e-mail

{
  "TemplateIds": [
    2393
  ],
  "RecipientEmails": [
    "wihej24992@marvetos.com"
  ],
  "CopyContactEmails": [
    "info@colengo.com"
  ],
  "FromEmail": "cs@colengo.com",
  "AttachmentIds": [1122],
  "Data": {
    "Company": "Colengo",
    "CustomerName": "Wihej 24992"
  },
  "Language": "NL"
}

Voorbeeldverzoek voor een sms

{
  "TemplateIds": [
    2489
  ],
  "RecipientPhoneNumbers": [
    "0999999999"
  ],
  "FromPhoneNumber": "0909369999",
  "Data": {
    "Company": "Colengo",
    "CustomerName": "Wihej 24992"
  },
  "Language": "NL"
}