Skip to main content

Engagement Hub — Quick Guide

Audience: Coordinators and account owners using Aventora Admin → Engagement Hub.

How to set up time and calendar, configure call behavior, run Single and Bulk outreach, review Analysis, and set Notifications. This guide does not cover telephony provisioning, CRM sync, APIs, Chat Center, Email Pull setup, or Campaigns.

First login? Complete the Engagement Hub Onboarding Guide first. For deeper ops detail, see User Manual — Part 3.

Account, calendar, and time​

Path: Engagement Hub → Account Settings → Calendar

Use this so outreach only runs when you are available, and so appointment booking can offer real open slots.

Working hours​

  1. Open Account Settings → Calendar.
  2. Under Working Hours, expand Call Availability (phone) and Messaging Availability (SMS / WhatsApp).
  3. For each weekday, set Available or Unavailable, then start and end times.
  4. Use Available for calls when you want outbound bridges and inbound rings; switch to Not available (away) when you are out (messaging hours are separate).
  5. Click Save working hours for each section you change (call and messaging save separately).

Hub schedules calls and callbacks inside these windows.

Timezone and appointment defaults​

Still on Calendar, in Calendar Settings:

  1. Set Timezone (and Domain timezone (office hours) if your office timezone differs).
  2. Set Appointment Duration (minutes), Business Start Hour / Business End Hour, Days Ahead, and Buffer Minutes as needed for booking.
  3. Turn on Enable Calendar Integration when you want Outlook/Google used for availability.
  4. Click Save All Settings at the bottom of Account Settings.

Working hours are saved with Save working hours; they are not included in Save All Settings.

Connect Outlook or Google​

Needed for appointment-booking outreach.

  1. On the Calendar tab, under Calendar Authorization, choose Outlook or Google.
  2. Click Authorize Outlook or Authorize Google and finish the popup sign-in.
  3. Confirm the badge shows Connected / Calendar Connected.

You can also manage personal scheduling under Aventora Calendar (same Account Settings page) or Engagement Hub → Calendar. If Aventora Calendar has no hours saved for a user, Domain Assistant fills Monday–Friday, 9:00 AM–5:00 PM and booking offers the first remaining slot after now (in that user's timezone). Confirm the display number customers see was set during onboarding (or by your account owner).

Call settings​

Path: Engagement Hub → Account Settings → Calls

Account owners use Call Settings to control how outbound work behaves for the whole organization.

  1. Open Account Settings → Calls.
  2. Adjust the settings below.
  3. Click Save All Settings.
SettingHow to use it
Pause Engagement HubTurn on to stop all outbound calls and messages (for example during an outage or holiday). Queued work is rescheduled. Turn off when you are ready to resume.
Max Concurrent Calls Per UserSet how many phone calls one user may run at once. Lower this if you want a lighter load on staff bridges.
Default Call Duration (minutes)Used when a Single or Bulk call does not specify a duration. Match a typical conversation length for your team.
Customer dedup window (days)Enter days to skip contacts already contacted recently on CSV/bulk uploads (and email pull). Use 0 to turn dedup off. Does not apply to Single Call.
SMS Fallback When Call Center ClosedTurn on if a phone call is due outside call hours: Hub can start by SMS when messaging hours are open, then schedule the phone call when call hours reopen. Broker callbacks booked over SMS still use call hours (not 24/7 messaging hours).
Play Chime at Call StartTurn on if you want a short chime when a phone call begins.

Other Call Settings (retries, call switching, domain questions) are available on the same tab for advanced tuning; leave defaults unless your team has a specific process.

Single Call​

Path: Engagement Hub → Single Call

Use for one-off outreach: a VIP callback, a confirmation, or a test before a bulk run.

Start a call or message​

  1. Open Single Call.
  2. Click Start New Call (page may show Initiate Single Call).
  3. Fill the form:
    • Client Name and Client Email (required).
    • Phone Number (required unless Channel is Email).
    • Call Type: Informational, Confirmational, Appointment Booking, or Conversational.
    • Channel: Phone Call, SMS Message, WhatsApp Message, WhatsApp Voice, or Email (options depend on your account).
    • Instruction (required): what the assistant should say or accomplish (at least a short clear sentence).
  4. Optional fields when they appear:
    • Instruction mode (non-email): Override, Script, or Context — use Script when the opening must be said verbatim.
    • Calendar Routing (Appointment Booking): your calendar or any team member.
    • Broker Phone Number (Conversational), Call Duration (phone), Language, Booking ID (Confirmational), email template/subject (Email).
  5. Click Make Call, Send Message, or Send Email (label matches the channel).
  6. On success you return to the list; check Recent Calls (Contact, Type, Channel, Status, Outcome). Use Refresh if status is still updating.

If the contact is on a do-not-contact list or has hit max attempts, Hub blocks the send and shows an error — fix the contact or wait before retrying.

Bulk Call​

Path: Engagement Hub → Bulk Call

Use for list campaigns (reminders, confirmations, re-engagement). Check credits on the Dashboard before large uploads.

Standard CSV or Excel upload​

Best when your file already has Hub columns (phone, name, instruction, and related fields). See Bulk Call CSV Guide.

  1. Open Bulk Call.
  2. Under Upload Call List → Select File and Upload, choose your CSV or Excel file.
  3. Optionally Download Sample CSV Template or expand View File Format Details if you are unsure of columns.
  4. Click Upload and Queue.
  5. If Hub finds duplicates, choose Remove duplicates and continue or Cancel upload.
  6. On success, note the Batch / Job IDs under Upload Successful! or Upload Accepted.
  7. Monitor Batch History (File Name, Status, Total, Completed, Failed, Queued). Status moves from ingesting to processing as rows run.

Mapped Upload​

Best when the spreadsheet only has contact columns (for example phone and name) and you want shared defaults for the whole file.

  1. On Bulk Call, click Mapped Upload and select the file.
  2. On the Mapped Upload page, set shared defaults: call type, channel, language, duration, phones, and Instruction (required).
  3. Map each required column (or choose “use form value” where offered). Phone or email must map depending on channel.
  4. For large files (over 100 rows), set Segment size / Row segment if prompted.
  5. Click Upload and Queue, then Back when finished. Track progress in Batch History.

Applied Upload​

For Applied Systems CSV exports.

  1. Click Applied Upload and select the Applied Systems CSV.
  2. In the Applied Upload dialog, set Call type, Channel, Instruction (required), and optional Phone.
  3. Click Upload and Queue. Defaults are saved on the account for next time.

Analysis​

Path: Engagement Hub → Analysis (page title Call Analysis)

Tabs: Ask AI | Analytics | Call Details | Reports.

Filter what you are looking at​

On Analytics (and shared filter context):

  1. Open the Filter Calls card.
  2. Set Inbound channel (All, Single call, Bulk uploads, or a specific bulk Batch).
  3. Set Date Range.
  4. Click Refresh when the button appears after you change filters.

Call Details — review one engagement​

  1. Open the Call Details tab.
  2. Use filters: search by phone, call SID, or instruction; set Status / Outcome / Channel / Call Type; click Apply Filters.
  3. In Call Logs, find the row (Contact, Type, Channel, Status, Outcome, Started, Attempts).
  4. Open the row to view Conversation History / Call Details. Call Information shows contact, status, and Notifications (who was notified, which rule/event, and when).
  5. Status and Outcome cells can be edited when your role allows — use that to correct an obvious mis-label after review.

Analytics — campaign health​

  1. Open Analytics and apply filters as above.
  2. Read Total Calls, Success Rate, Unique Outcomes, and Issue Rate.
  3. Use charts such as Call Outcome Distribution to see what happened across the period.

Ask AI — campaign intelligence​

  1. Open Ask AI (may show Experimental or Coming soon depending on your account / ASK_AI_ENABLED).
  2. If enabled: set campaigns and date filters.
  3. Reports (opens first): pick a predefined report card and click Run analysis. Use the info icon on each card to read what that report returns.
  4. Conversation: click the info icon for question types and asking tips. Ask a reporting question (dates and channel can be in the question or filters). Follow-ups such as “break that down by campaign” stay in the thread until you click New conversation or leave Analysis, and they keep the previous question’s date range. For staff who were alerted, ask who received the notification and how those engagements ended (for example connected calls); ask for recipient emails if you need the addresses.
  5. Review canned-report Results (summary, findings, recommendations, charts). Optionally print or export PDF when available.
  6. If Coming soon, use Analytics and Call Details instead.

Predefined reports cover overall engagement, campaign comparison, responder patterns, best day/time, retries and retry delay, channels and sequences, conversation quality, objections, first-message effectiveness, momentum, contact fatigue, campaign overlap, and a single biggest-improvement recommendation. Full descriptions live in Engagement Hub Features → Ask AI.

Reports — export​

  1. Open Reports. Reports are tabs on that panel: Operational, Conversations, Lead Score, Notifications, and Epic Producer.
  2. Operational: choose PDF or Excel options, then Generate & Download.
  3. Conversations: Open Conversations Report.
  4. Lead Score (if used): Load Lead Scores.
  5. Notifications: set Channel / Delivery status / Engagement outcome if needed, then Load notifications. Review the per-recipient summary (delivery success and phone answered rates). Open Show event details to drill into each alert. Export Excel downloads Recipients and Events sheets.
  6. Epic Producer: upload an Applied Epic Calls-Producer CSV/Excel, keep or clear the “Epic after engagement” checkbox, then Generate & Download Excel. Matching is by client phone; this is producer-call attribution, not policy premium.

Delivery success treats email/SMS/Teams sent or delivered and phone answered as success. Full per-recipient logging and phone answer status apply from the logging cutover forward. Older email/SMS/phone fires estimate the recipient from the rule destination list in round-robin order.

Common outcomes​

Appointment Booked, Appointment Confirmed, Connected, Replied, Callback Requested, Voicemail, No Answer, Do Not Call, Not Ready, Rescheduled.

Notifications​

Path: Engagement Hub → Notifications

Create rules so the right people are alerted when outreach needs attention.

Add a notification rule​

  1. Open Notifications → Add notification.
  2. Enter a Name (for example “Bulk reply alerts”).
  3. Choose Outbound channel:
    • Microsoft Teams — only after a webhook is enabled under Account Settings → Teams.
    • SMS, Phone, or Email — enter destination(s). For round-robin, add multiple emails or numbers separated by commas, semicolons, or new lines.
  4. Choose Inbound source: Bulk call (upload), Email pull, or API call (use Bulk call for list campaigns from this guide).
  5. Check the Events that should fire the rule:
    • Engagement is loaded
    • First outreach
    • Each outreach
    • Customer reply
    • Timed out
    • Not ready
  6. Choose how the rule matches:
    • Unconditional on — notify on every matching event; save, then activate when ready.
    • Unconditional off — paste a Sample inbound payload, click Analyze sample, build the Trigger condition, then Validate trigger. Re-validate after any trigger edit.
  7. Click Save.
  8. On the rules list, turn Active on. Activation requires Unconditional or a verified trigger. You should see Notification activated.

Optional after a conditional rule is saved and valid: Test notification to send a sample alert.

Manage round-robin pauses​

  • SMS recipients can reply PAUSE to leave the rotation and RESUME to return (do not use carrier STOP for a temporary pause).
  • Email out-of-office or bounce pauses that address; failed SMS delivery can too.
  • On Notifications, open Paused round-robin recipients and click Resume when someone should receive alerts again.

Edit or pause a rule​

Use the row Actions to edit or delete. Turn Active off to pause a rule without deleting it.

Path cheat sheet​

TaskWhere
Working hours & calendar connectAccount Settings → Calendar
Call behavior defaultsAccount Settings → Calls → Save All Settings
One outreachSingle Call → Start New Call
List campaignBulk Call → Upload / Mapped / Applied → Upload and Queue
Review one engagementAnalysis → Call Details
Campaign metricsAnalysis → Analytics
Ask AI reportsAnalysis → Ask AI → Reports (default tab)
Ask AI conversationAnalysis → Ask AI → Conversation
ExportsAnalysis → Reports
Epic producer attributionAnalysis → Reports → Epic Producer
Notification deliveryAnalysis → Reports → Notifications
Alert the teamNotifications → Add notification
Activity at a glanceHub home (KPIs + 7-day outcome charts) or Dashboard

Changelog​

DateChange
2026-08-19Ask AI Conversation has an info icon for question types and asking guidance (including notification recipients vs engagement outcomes).
2026-08-19Ask AI opens on Reports (15 canned cards); Conversation is the second tab. Follow-ups keep the previous question’s date range.
2026-08-19Hub home 7-day calls view is four separate charts (Connected, Voicemail, Not Ready, Max Attempts Reached) instead of one overlay.
2026-08-19Ask AI Conversation tab is a chat with follow-ups; the 15 canned reports are on Analysis → Ask AI → Reports. Channel-specific counts use first channel.
2026-08-18Analysis → Reports → Epic Producer: upload an Applied Epic Calls-Producer file and download a consolidated Excel matching Aventora engagements to producer calls by client phone.
2026-08-13Aventora Calendar: users with no saved hours get Monday–Friday 9:00 AM–5:00 PM; booking offers the first remaining slot after the current local time.
2026-08-12Call Details Notifications column uses the same call/engagement matching as the Notifications report, so sent alerts are not shown as “No one notified yet.”
2026-08-12Notifications report: stacked engagement outcomes, round-robin recipient estimate for older fires, and cancellable non-blocking load.
2026-08-12Notifications report: missing engagement outcome shows N/A instead of Unknown.
2026-08-12Broker callbacks booked over SMS use call working hours (not 24/7 messaging hours); after-hours callbacks notify the next opening instead of “connecting you now.”
2026-08-12Notifications report now includes historical alert fires from the notification ledger (same source as call-details “fired”), not only newly logged per-recipient rows.
2026-08-12Notifications report: historical alert fires now appear after Hub restart (backfill from the notification ledger).
2026-08-12Analysis → Reports: documented the Notifications report (per-recipient delivery + engagement outcome, Excel export).
2026-08-11Ask AI: documented info-icon report descriptions and the 15 predefined campaign intelligence reports; linked to Features guide.
2026-07-22Expanded Quick Guide with step-by-step how-to for calendar/time, Call Settings, Single/Bulk Call, Analysis tabs, and Notifications.
2026-07-22Initial Engagement Hub Quick Guide (account/calendar/time, Call Settings, Single/Bulk Call, Analysis tabs, Notifications).