Woot is a simple Chatwoot API wrapper for Python. It provides an easy-to-use interface for interacting with the Chatwoot API, allowing you to perform various actions such as creating, retrieving, updating, and deleting conversations, messages, and more.
Also, if you wonder how to use it for Chatwoot webhook have a look at woothook
To install Woot, simply run:
pip install git+https://github.com/dearkafka/woot
To use Woot, you'll first need to import the Chatwoot
or AsyncChatwoot
class from the woot
:
from woot import Chatwoot, AsyncChatwoot
Next, create an instance of Chatwoot
or AsyncChatwoot
by passing your Chatwoot URL and access key:
chatwoot = Chatwoot(chatwoot_url="https://your-chatwoot-instance.com", access_key="your-access-key")
Or, for the async version:
async_chatwoot = AsyncChatwoot(chatwoot_url="https://your-chatwoot-instance.com", access_key="your-access-key")
You can then access the various resources and perform actions on them as attributes of the Chatwoot
or AsyncChatwoot
instance.
You can also see details about specific methods, but remember woot takes keyword arguments only, no positional allowed
Woot provides access to various Chatwoot resources, such as:
- Conversations
- Messages
- Contacts
- Labels
- Teams
- Agents
- And more
To access a resource, use the appropriate attribute of the Chatwoot
or AsyncChatwoot
instance:
conversations = chatwoot.conversations
Each resource has a set of actions that can be performed, such as list
, create
, update
, and delete
. To perform an action, simply call the corresponding method on the resource:
all_conversations = conversations.list(account_id=1)
To view the available actions and their corresponding API endpoints for each resource, simply print the Chatwoot
or AsyncChatwoot
instance:
print(chatwoot)
This will display a list of available actions, their HTTP methods, and API endpoints.
Here's an example demonstrating how to use Woot to list all conversations:
from woot import Chatwoot
chatwoot_url = "https://your-chatwoot-instance.com"
access_key = "your-access-key"
chatwoot = Chatwoot(chatwoot_url=chatwoot_url, access_key=access_key)
conversations = chatwoot.conversations
all_conversations = conversations.list(account_id=1)
print(all_conversations)
Project is influenced by and borrowed from simple_rest_client and in fact started by using it as it is, but then I decided to make it more Chatwoot specific and add some features that I needed.
The project is licensed under the Cooperative Non-Violent Public License v7 or later (CNPLv7+) - see the LICENSE for details. Built for people, not corporations.