Integraties

E-mail versturen vanuit Dify

Bouw AI-workflows zonder code — koppel Wesender als HTTP-actieblok in je Dify-workflow.

Automation Geen code Webhooks

Vereisten

  • Dify-account (cloud op dify.ai of self-hosted via Docker)
  • Wesender-account met API-sleutel
  • Een bestaande of nieuwe Dify-workflow
  • Geen programmeerkennis vereist

Stap 1: Maak een nieuwe Dify-workflow aan

Log in op Dify en navigeer naar Studio → Workflow → Nieuw aanmaken. Kies het type Workflow (niet Chatflow). Geef de workflow een naam, bijv. 'Welkomstmail verzenden'.

Stap 2: Configureer het Start-blok met invoervariabelen

Klik op het Start-blok en voeg invoervariabelen toe: to_email (tekst) en naam (tekst). Deze worden ingevuld bij het starten van de workflow.

Variabelen in het Start-blok:
  Naam: to_email   Type: Tekst   Label: E-mailadres ontvanger
  Naam: naam       Type: Tekst   Label: Naam ontvanger

Stap 3: Voeg een LLM-blok toe voor de e-mailinhoud

Voeg een LLM-blok toe om een gepersonaliseerde e-mailtekst te genereren. Verbind het Start-blok als invoer en gebruik variabelen via Dify-expressies.

Systemprompt:
Je bent een assistent die welkomstmails schrijft in HTML.

Gebruikersprompt:
Schrijf een welkomstmail in HTML voor {{#start.naam#}}.
De mail moet warm, professioneel en kort zijn.

Stap 4: Voeg een HTTP-verzoekblok toe voor Wesender

Voeg een HTTP-verzoek-blok toe. Stel methode, URL, headers en body in om de Wesender API aan te roepen. Verwijs naar LLM-output via de Dify-expressie {{#llm.text#}}.

Methode:  POST
URL:      https://api.wesender.nl/v1/emails

Headers:
  Authorization:  Bearer {{WESENDER_API_KEY}}
  Content-Type:   application/json

Body (JSON):
{
  "from":    "noreply@jouwdomein.nl",
  "to":      "{{#start.to_email#}}",
  "subject": "Welkom bij ons platform",
  "html":    "{{#llm.text#}}"
}

Stap 5: Sla de API-sleutel op als omgevingsvariabele

Navigeer naar Instellingen → Omgevingsvariabelen en voeg WESENDER_API_KEY toe met je Wesender API-sleutel. Verwijs er in het HTTP-blok naar via {{WESENDER_API_KEY}} zodat de sleutel nooit zichtbaar is in de workflow-configuratie.

Stap 6: Test en publiceer de workflow

Klik op Uitvoeren in de workflow-editor, vul testwaarden in voor to_email en naam, en controleer of de e-mail aankomt. Publiceer de workflow: Dify genereert een API-eindpunt waarmee je de workflow vanuit externe systemen kunt triggeren.

Volledig voorbeeld

Hier is de volledige implementatie in dify-workflow-config.json:

{
  "workflow_name": "Welkomstmail verzenden",
  "nodes": [
    {
      "type": "start",
      "variables": [
        { "key": "to_email", "type": "string", "label": "Ontvanger e-mailadres" },
        { "key": "naam",     "type": "string", "label": "Naam ontvanger"        }
      ]
    },
    {
      "type": "llm",
      "model": "gpt-4o",
      "system_prompt": "Je bent een assistent die welkomstmails schrijft in HTML.",
      "user_prompt": "Schrijf een welkomstmail in HTML voor {{#start.naam#}}."
    },
    {
      "type": "http_request",
      "method": "POST",
      "url": "https://api.wesender.nl/v1/emails",
      "headers": {
        "Authorization": "Bearer {{WESENDER_API_KEY}}",
        "Content-Type":  "application/json"
      },
      "body": {
        "from":    "noreply@jouwdomein.nl",
        "to":      "{{#start.to_email#}}",
        "subject": "Welkom bij ons platform",
        "html":    "{{#llm.text#}}"
      }
    }
  ]
}

Bezorgstatussen via webhooks

Dify kan bezorg-, bounce- en klachtsignalen ontvangen via webhooks. Configureer een webhook-endpoint in je Dify-workflow dat POST-verzoeken van Wesender accepteert. Zie Webhooks instellen voor de volledige configuratiestappen en het payload-formaat.

Veelgestelde vragen

Kan ik Dify self-hosten voor volledige datacontrole?

Ja. Dify is open-source en kan via Docker worden gehost op je eigen server. Combineer dit met de Wesender API voor een volledig Europese, self-hosted AI-e-mailoplossing.

Hoe trigger ik de workflow vanuit een extern systeem?

Na publicatie genereert Dify een API-eindpunt. Stuur een POST-verzoek naar dit eindpunt met je inputs als JSON-body en de Dify API-key als Bearer-token. Zo koppel je de workflow aan je CRM, webshop of andere systemen.

Kan ik bezorgingsstatussen terugkrijgen in Dify?

Voeg een tweede HTTP-blok toe om een Wesender-webhook te registreren, of gebruik een externe integratie zoals Make of Zapier om bezorgingsevents te ontvangen en terug te koppelen aan een Dify-workflow via de Run API.

Volgende stappen