Vitally
Integrate your customer success platform data for comprehensive account insights.
Vitally integration brings your customer success platform data directly into Formata meeting briefs, providing comprehensive account health, engagement metrics, and customer journey insights. This optional integration is essential for teams already using Vitally as their primary customer success platform.
Why Vitally Integration Transforms Your Briefs
Vitally integration enriches your meeting preparation by providing:
Account health scores and trend analysis
Customer journey mapping and lifecycle stage information
Product usage analytics and engagement patterns
Risk indicators and churn prediction insights
Success milestones and achievement tracking
Team notes and activities from your CS platform
Custom attributes and account-specific data points
For teams using Vitally, this integration ensures your meeting briefs include the complete customer success context you rely on for strategic account management.
What Formata Accesses
When you connect Vitally, Formata requests access to:
✅ Account information
Customer account profiles and basic details
Account health scores and status indicators
Lifecycle stage and journey progression
Custom fields and account attributes
✅ Engagement data
Product usage metrics and activity levels
Feature adoption and utilization patterns
User behavior and interaction analytics
Engagement trend analysis
✅ Success metrics
Milestone achievements and goal progress
Risk scores and churn probability indicators
Expansion opportunities and growth signals
Customer satisfaction and NPS data
✅ Activity records
Team interactions and touchpoint history
Notes and comments from CS team members
Task completion and follow-up tracking
Timeline of customer success activities
Formata operates with read-only access and never modifies account data, scores, or activities in your Vitally platform.
Setup Process
Setting up Vitally integration requires your Vitally subdomain and authentication credentials:
Step 1: Gather Required Information
Before starting, collect:
Vitally subdomain: Your organization's Vitally URL (e.g.,
yourcompany.vitally.io
)Basic Auth Token: Your Vitally API authentication token
Finding Your Vitally Subdomain
Your subdomain is the first part of your Vitally URL:
If your Vitally URL is
acmecorp.vitally.io
, your subdomain isacmecorp
If your URL is
techsolutions.vitally.io
, your subdomain istechsolutions
Getting Your Basic Auth Token
Log into your Vitally account
Navigate to Settings → API Tokens
Create a new token or copy an existing read-only token
Ensure the token has permissions for account and activity data
Step 2: Configure Integration
Navigate to the Integrations page in your Formata dashboard
Find the Vitally section
Click Add Vitally Integration
Step 3: Enter Credentials
Enter your Vitally subdomain (without
.vitally.io
)Paste your Basic Auth Token
Click Test Connection to verify credentials
Click Connect to complete setup
Step 4: Confirm Connection
Once connected, you'll see:
✅ Vitally: Connected status in your integrations dashboard
Your Vitally subdomain and connection details
Total setup time: 2 minutes
How Vitally Data Enhances Briefs
Formata intelligently incorporates Vitally data to provide comprehensive account context:
Account Matching
Customer identification:
Email domain matching: Links meeting attendees to Vitally accounts
Company name correlation: Matches calendar entries with Vitally account names
Contact association: Connects individual attendees to broader account context
Data Prioritization
High-impact insights:
Health score changes: Recent improvements or declines in account health
Risk indicators: Churn probability and warning signals
Engagement trends: Usage pattern changes and activity levels
Milestone progress: Recent achievements or missed goals
Team activities: Recent CS team interactions and notes
Vitally Data Categories
Account Health & Scoring
Overall health scores with trend analysis
Category breakdowns (usage, engagement, support)
Risk assessment and churn probability
Health score history and change indicators
Product Usage & Engagement
Login frequency and session duration
Feature adoption rates and utilization
User activity patterns and behaviors
Engagement benchmarks compared to cohorts
Customer Journey & Lifecycle
Current lifecycle stage and progression
Onboarding completion status
Milestone achievements and upcoming goals
Journey timeline and key events
Team Activities & Notes
Recent interactions by CS team members
Activity summaries and touchpoint history
Internal notes and strategic observations
Task tracking and follow-up items
Troubleshooting
"No Vitally data in briefs"
Check these common issues:
Account matching: Ensure meeting attendee email domains match Vitally account domains
Token permissions: Verify your API token has read access to required data
Subdomain accuracy: Confirm subdomain entered correctly (without .vitally.io)
"Vitally connection failed"
Authentication issues:
Invalid subdomain: Double-check your Vitally URL format
Expired token: Generate a new API token in Vitally settings
Insufficient permissions: Ensure token has account and activity read access
Network restrictions: Check if your organization blocks API connections
API Token Management
Token Security Best Practices
Read-only permissions: Use tokens with minimal required permissions
Regular rotation: Update API tokens periodically for security
Access monitoring: Review token usage through Vitally's API logs
Team coordination: Coordinate token management with Vitally administrators
Token Permissions Required
Minimum permissions needed:
Account data: Read access to customer account information
Activity data: Access to customer success activities and notes
Metrics data: Read access to health scores and engagement metrics
User data: Basic user and contact information
Managing Multiple Tokens
For team usage:
Shared service token: Use dedicated integration token for team access
Individual tokens: Each team member can use personal tokens if preferred
Permission consistency: Ensure all tokens have consistent data access
Managing Your Integration
Updating Credentials
To change your Vitally connection details:
Go to Integrations in your dashboard
Click Configure next to Vitally
Update subdomain or API token as needed
Test the new connection before saving
Reconnecting
If your integration becomes disconnected:
Click Reconnect next to Vitally in your dashboard
Re-enter your credentials
Test the connection to ensure proper access
Disconnecting
To remove Vitally access:
Click Disconnect in your Formata integrations dashboard
Optionally revoke the API token in your Vitally settings
Note: Disconnecting Vitally will remove customer success platform insights from your meeting briefs but won't affect other integration data.
Integration Best Practices
For Customer Success Teams
Token management: Use dedicated service tokens for team integrations
Account organization: Maintain consistent account naming in Vitally for better matching
Data hygiene: Keep Vitally account information current for accurate brief context
For Vitally Administrators
API governance: Monitor token usage and maintain security standards
Permission management: Ensure integration tokens have appropriate access levels
Data quality: Maintain accurate account and contact information for better matching
Next Steps
Once your Vitally integration is connected:
Schedule a test meeting with a customer who has an active Vitally account
Review enhanced briefs to see customer success data in context
Optimize account matching by ensuring consistent naming conventions
Combine with other integrations for complete customer intelligence
Last updated