Email not delivered
import { Aside } from “@astrojs/starlight/components”;
PointOfContactAI sends transactional emails (purchase confirmation, plan change, suspension notice, quota grace, cancellation) via Azure Communication Services Email. We use an Azure-managed domain for the FROM address (DoNotReply@<guid>.azurecomm.net).
First email after install may be delayed
Azure-managed email domains can take 5-15 minutes to fully propagate DNS records (SPF, DKIM, DMARC) the first time they’re used. During that window:
- Some recipient mail servers reject the email entirely (no record yet).
- Some accept it but route it to spam.
- After propagation completes, subsequent emails deliver normally to the inbox.
What to do: if your welcome email hasn’t arrived within 20 minutes:
- Check spam/junk folder.
- Wait another 15 minutes; transient propagation issues usually clear within 30 minutes total.
- If it never arrives, contact support with your marketplace subscription id — we can resend.
Spam classification
The default Azure-managed domain (*.azurecomm.net) has a neutral domain reputation. Some corporate spam filters flag any unknown domain. Two mitigations:
- Allowlist
DoNotReply@*.azurecomm.netin your email gateway. - Custom verified domain (coming in v1.1) — we’ll let you point a CNAME at your own domain so emails come from
noreply@yourcompany.cominstead.
What emails to expect
| Event | |
|---|---|
| Purchase | ”Welcome to PointOfContactAI — your {plan} subscription is ready” |
| Plan change | ”Your PointOfContactAI plan is now {newPlan}“ |
| Suspension (billing issue) | “Action needed — your PointOfContactAI subscription is suspended” |
| Reinstatement | ”Welcome back — your PointOfContactAI subscription is active” |
| Cancellation | ”Your PointOfContactAI subscription has been cancelled” |
| Seat quota exceeded (day 0) | “You’re over your seat quota — N days to upgrade” |
All six templates render in major mail clients including Outlook 2016+, Apple Mail, Gmail web/app.
Testing the email path
If you’re a support engineer at our company debugging an email-related issue, the ISV control plane has an admin-test endpoint:
curl -X POST 'https://pocai-isv-cp.azurewebsites.net/api/ops/email-test?code={func-key}' \ -H 'Content-Type: application/json' \ -d '{"toAddress":"you@example.com","template":"purchase-confirmation"}'Returns a correlationHash you can use to trace the send in our App Insights.