Real Bots

Verify Google Connection

SALESFORCE ADMIN

This is the final end-to-end post-install test. Run it from Salesforce after every configuration step is complete.

Where to run it

Salesforce → Relationship Intelligence Configuration → Verify Google Connection

Salesforce credential preflight

Before running the test, confirm that each of these exists and is granted to the running user — see Named & External Credentials.

External Credential: EIE_Relationship_Intelligence_Auth
Principal:           EIE_RI_Principal
Named Credential:    EIE_Relationship_Intelligence
Permission Set:      Relationship Intelligence

Expected result

Google Workspace connection verified successfully.

Success: true
Google Connection: Connected
Directory API: Operational
Domain Delegation: Verified
Gmail API: Operational
CheckExpected result
Successtrue
Google ConnectionConnected
Directory APIOperational
Domain DelegationVerified
Gmail APIOperational

Relationship Intelligence is ready when all verification checks return successfully.

A successful result proves that:

  • Salesforce could access the Named Credential.
  • The running user had External Credential Principal Access.
  • The Real Bots package created its RS256 assertion.
  • EIE verified the Salesforce certificate and KID.
  • EIE resolved the correct tenant.
  • Google Domain-Wide Delegation was authorized.
  • Directory API access succeeded.
  • Gmail metadata access succeeded.

What this test proves

A successful result verifies the complete chain:

Salesforce
        →
Real Bots
        →
RS256 assertion
        →
EIE public API
        →
tenant resolution
        →
registered Salesforce certificate
        →
Google Workspace provider
        →
Domain-Wide Delegation
        →
Directory API
        →
Gmail API

Any failure isolates the break to one of those links. Map the message you receive to a cause in Troubleshooting.

Failure mappings

FailureLikely causeWhere to fix
Invalid service-account credentialJSON is malformed, revoked, disabled, or belongs to another tenantGoogle Cloud Service Account Setup
Delegation not authorizedClient ID is missing from Google Admin ConsoleGoogle Workspace Configuration
Unauthorized scopeOne or more required OAuth scopes are missing or incorrectGoogle Workspace Configuration
Directory API unavailableAdmin SDK API is disabled or the admin subject is invalidGoogle Cloud Service Account Setup
Gmail API unavailableGmail API is disabled, the scope is missing, or the test mailbox is invalidGoogle Cloud Service Account Setup
Domain mismatchEIE Workspace Domain does not match the connected Google Workspace tenantEIE Configuration
Subject not foundWorkspace Admin Subject does not exist or is suspendedGoogle Cloud Service Account Setup
Mailbox not foundTest Mailbox is invalid, suspended, unlicensed, or outside the authorized tenantTroubleshooting

Was this helpful?

Last updated 1 month ago