Getting started

Introduction

What Communication does, who sends through it, and what you can configure.

The Communication service is the transactional email backbone of Vlozi. Every outbound email sent by the platform — newsletter campaigns, OTP codes, chatbot proactive messages, form submission notifications — flows through this single service.

You don't need to manage email infrastructure. Vlozi handles delivery, tracks results, and routes bounce and complaint events back to the services that need them. What you configure is the from address and brand identity that appear on every email we send on your behalf.

What it does

Capability Description
Transactional email Sends single emails (or bulk via newsletter) with your sender identity
Sender settings Configure your name, reply-to address, and brand colours
Vlozi aliases Claim a branded name@vlozi.app sending address
Delivery tracking Real-time events: delivered, bounced, opened, clicked, complained
Send logs Searchable history of every email sent from your account
Newsletter integration Delivery events (opens, clicks, bounces) automatically update newsletter analytics

Who uses it

Communication is used by other Vlozi services on your behalf:

Service Emails it sends
Newsletter Campaign and broadcast emails to your subscribers
Forms Submission notification emails
Chat Engine Proactive outreach messages (when a contact is via email channel)
Platform Account OTPs, billing alerts, password resets

For Newsletter users: your sender identity here is the "From" that appears in your subscribers' inboxes. Setting it up correctly is the most important step before sending a campaign.

What you configure

Sender identity — the name and address your recipients see. Configure it once in Communication Settings and it applies to all outbound emails from your account.

Vlozi alias — an optional yourname@vlozi.app address you can claim as your dedicated sending address. Useful if you want branded email without managing your own domain.

Brand kit — your logo URL and primary colour, used in the default email templates.

Sending email via API

If you want to trigger transactional emails from your own application:

POST /comms/v1/send
x-tenant-id: {your-tenant-id}
Content-Type: application/json
 
{
  "channel": "email",
  "to": "customer@example.com",
  "subject": "Your order is confirmed",
  "content": {
    "html": "<p>Thank you for your order!</p>",
    "text": "Thank you for your order!"
  }
}

The email is sent using your configured sender name and address (or the Vlozi default if not configured). Delivery status is available in the send logs.

Communication · Getting startedEdit on GitHub