Omnium Hub Skill

This skill allows you to interact with the Omnium Hub CRM.

Prerequisites

To use this skill, you need an Omnium Hub API Key.

• If you do not have an API key, ask the user for it: "Please provide your Omnium Hub API Key to proceed."
• Once provided, use it in the scripts below.

Tools

1. Manage Contacts

Use scripts/omnium_client.py to manage contacts.

Usage:

python3 scripts/omnium_client.py --api-key "YOUR_KEY" contacts --action [lookup|create|update] --email "user@example.com" [other options]

Actions:

• lookup: Find a contact by email or phone.
• create: Create a new contact.
• update: Update an existing contact.

Examples:

• "Find the contact for john@example.com in Omnium Hub."

-> python3 scripts/omnium_client.py --api-key "..." contacts --action lookup --email "john@example.com"

• "Add Jane Doe (jane@test.com) to Omnium Hub."

-> python3 scripts/omnium_client.py --api-key "..." contacts --action create --first-name "Jane" --last-name "Doe" --email "jane@test.com"

2. Manage Opportunities

Use scripts/omnium_client.py with the opportunities command.

Usage:

python3 scripts/omnium_client.py --api-key "YOUR_KEY" opportunities --action list --pipeline-id "..."

Troubleshooting

• 401 Unauthorized: The API Key is invalid. Ask the user to check their Omnium Hub credentials.
• 404 Not Found: The contact or resource does not exist.