Python library to interact with HubSpot's Private API
Project description
HubSpot Private API
Python library to interact with HubSpot's Private API
Because HubSpot doesn't bother to make their Public API feature-complete, and have had some modules in BETA for over a year (khm.. Conversations), I reverse engineered their Private API that their mobile app uses.
Additional features, which their Public API doesn't support:
- Conversation: access Live Chat channels
- Conversation: Assign the conversation to an agent
Which is required for any kind of LLM automation / auto-reply (to live chats).
Demo script
from hubspot_api import HubSpotApi
def cb_auth() -> str: # In case of 2FA, you'll need to return the code
code = input('Enter 2FA code: ')
return code
hs = HubSpotApi('my-email@provider.com', 'superSecretPw', cb_auth)
# You can also do hs.conversations.get_threads() to get all threads
threads = hs.conversations.get_unassigned_threads()
# Needed for assigning threads to agents
assignees = hs.conversations.get_assignees()
for t in threads:
print('---------\nSubject:',t.subject, t.timestamp)
msgs = t.read_messages()
email_msgs = [f"FROM: {msg.fromName}, AT: {msg.timestamp}, EMAIL TEXT:\n{msg.text}" for msg in msgs]
full_conversation = f'EMAIL SUBJECT: {t.subject}\n' + '\n\n'.join(email_msgs).lower()
# Do some smart LLM stuff here
if "api" in full_conversation or "code" in full_conversation:
t.assign(assignees.find('John Doe')) # Tech support
elif "shipping" in full_conversation:
t.assign(assignees.find('Erik The Red')) # Ops/shipping
elif "digital agency" in full_conversation:
# They are trying to sell us something
t.send_message("Thank you for your email, but we are not interested.")
t.close()
elif "tiktok" in full_conversation:
t.spam() # TikTok? Spam for sures
Installation
To install this Python package, run the following command:
pip install hubspot-api
Liability
Note: This unofficial API library is not endorsed by HubSpot and likely violates their Terms of Service. Use it at your own risk; the creator assumes no liability for any consequences.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for hubspot_api-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 027e43d1231ea71eddfff3a7cbc35bec105f52d8fb5f943cdb244937005afca1 |
|
MD5 | 52cdc8b6253f74a04b366aaa5d037d3a |
|
BLAKE2b-256 | 90e659a0cef8ff19a2169bf9ee8cb4da1bed61eeab5f8e569aa5d1f9f38ba750 |