Send-by-Tag (PII aus öffentlichen Seiten heraushalten)

Manche Integrationen — eine Buchungsbestätigungsseite, ein Retourenportal — müssen eine Nachricht auslösen, ohne die Telefonnummer oder E-Mail-Adresse des Empfängers im HTML der Seite oder in clientseitigem JavaScript offenzulegen.

Das Muster

1. Legen Sie einmalig einen benannten Empfänger an: POST /v1/recipients mit { tag, channel, recipient }.
2. Lösen Sie aus Ihrem Backend einen Versand per Tag aus statt über die reine Adresse:

curl -X POST https://api.wezend.com/v1/messages/send-by-tag \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_tag": "booking-42891",
    "subject": "Ihre Buchung ist bestätigt",
    "message": "Wir sehen uns am Donnerstag um 14:00 Uhr."
  }'

Nur das Tag muss jemals den Browser oder einen Seitenbaukasten eines Drittanbieters erreichen — die Plattform löst es serverseitig zum echten Empfänger auf.

Anhänge (nur E-Mail)

Übergeben Sie attachment: { filename, content (base64), contentType }, um inline anzuhängen, oder media_url mit Verweis auf eine bereits über Media hochgeladene Datei. Anhänge werden bei SMS/WhatsApp nicht unterstützt — fügen Sie stattdessen einen Link in den Nachrichtentext ein.

Dieser Endpoint erfordert einen API-Key (kein Dashboard-JWT) — er ist für Server-zu-Server-Aufrufe ausgelegt.