Crisp API Python.

These details have not been verified by PyPI

Project links

Homepage

Environment
- Web Environment
Intended Audience
- Developers
Natural Language
- English
Programming Language
- Python

Project description

Crisp API Wrapper

The Crisp API Python wrapper. Authenticate, send messages, fetch conversations, access your agent accounts from your Python code.

📝 Implements: REST API Reference (V1) at revision: 16/01/2023
😘 Maintainers: @valeriansaliou, @eliottvincent

Usage

You may follow the REST API Quickstart guide, which will get you running with the REST API in minutes.

Install the library:

pip install crisp-api

Then, import it:

from crisp_api import Crisp

Construct a new authenticated Crisp client with your identifier and key tokens.

client = Crisp()

client.set_tier(tier)
client.authenticate(identifier, key)

Then, your client is ready to be consumed!

Authentication

To authenticate against the API, obtain your authentication token keypair by following the REST API Authentication guide. You'll get a token keypair made of 2 values.

Keep your token keypair values private, and store them safely for long-term use.

Then, add authentication parameters to your client instance right after you create it:

client = Crisp()

# Authenticate to API with your plugin token (identifier, key)
# eg. client.authenticate("13937834-f6ce-4556-ae4f-9e0c54faf038", "eb6c3623245521d7a6c35f5b29f3fa756e893f034ed551d84518961c5ff16dec")
client.set_tier("plugin")
client.authenticate(identifier, key)

# Now, you can use authenticated API sections.

Resource Methods

Most useful available Crisp API resources are implemented. Programmatic methods names are named after their label name in the REST API Reference.

All methods that you will most likely need when building a Crisp integration are prefixed with a star symbol (⭐).

In the following method prototypes, crisp is to be replaced with your Crisp API instance. For example, instanciate client = Crisp() and then call eg: client.website.list_conversations(website_id, 1).

When calling a method that writes data to the API (eg. send a message with: client.website.send_message_in_conversation()), you need to submit it this way:

website_id = "88972681-a00c-4b3b-a383-cab281636484"
session_id = "session_9df2a21e-f113-41d4-8ed2-bad8b49cafd1"

client.website.send_message_in_conversation(
  website_id, session_id,

  {
    "type": "text",
    "content": "This message was sent from python-crisp-api! :)",
    "from": "operator",
    "origin": "chat"
  }
)

⚠️ Note that, depending on your authentication token tier, which is either user, website or plugin, you may not be allowed to use all methods from the library. When in doubt, refer to the library method descriptions below. Most likely, you are using a plugin token.

Website

Website Conversations
- ⭐ List Conversations: Reference
  - client.website.list_conversations(website_id, page_number)
  - See Example
```
website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
page_number = 1

client.website.list_conversations(website_id, page_number);
```
- Search Conversations: Reference
  - client.website.search_conversations(website_id, page_number, search_query, search_type, search_operator, include_empty, filter_unread, filter_resolved, filter_not_resolved, filter_mention, filter_assigned, filter_unassigned, filter_date_start, filter_date_end, order_date_created", order_date_updated)
  - See Example
```
website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
page_number = 1

client.website.list_conversations(website_id, page_number);
```

Website Conversation

⭐ Create A New Conversation: Reference

client.website.create_new_conversation(website_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.create_new_conversation(website_id);

Check If Conversation Exists: Reference

client.website.check_conversation_exists(website_id, session_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.check_conversation_exists(website_id, session_id);

⭐ Get A Conversation: Reference

client.website.get_conversation(website_id, session_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.get_conversation(website_id, session_id);

Remove A Conversation: Reference

client.website.remove_conversation(website_id, session_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.remove_conversation(website_id, session_id);

Initiate A Conversation With Existing Session: Reference

client.website.initiate_conversation_with_existing_session(website_id, session_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.initiate_conversation_with_existing_session(website_id, session_id);

⭐ Get Messages In Conversation: Reference

client.website.get_messages_in_conversation(website_id, session_id, query)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.get_messages_in_conversation(website_id, session_id, query);

Send A Message In Conversation: Reference

client.website.send_message_in_conversation(website_id, session_id, query)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

query = {
  "type": "text",
  "from": "operator",
  "origin": "chat",
  "content": "Hey there! Need help?"
}

client.website.send_message_in_conversation(website_id, session_id, query);

Get A Message In Conversation: Reference

client.website.get_message_in_conversation(website_id, session_id, fingerprint)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
fingerprint = 524653764345

client.website.get_message_in_conversation(website_id, session_id, fingerprint);

Update A Message In Conversation: Reference

client.website.update_message_in_conversation(website_id, session_id, fingerprint, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
fingerprint = 524653764345

data = "Hey there! Need help?"

client.website.update_message_in_conversation(website_id, session_id, fingerprint, data);

Compose A Message In Conversation: Reference

client.website.compose_message_in_conversation(website_id, session_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

data = {
  "type": "start",
  "from": "operator"
}

client.website.compose_message_in_conversation(website_id, session_id, data);

⭐ Mark Messages As Read In Conversation: Reference

client.website.mark_messages_read_in_conversation(website_id, session_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

data = {
  "from": "operator",
  "origin": "urn:crisp.im:slack:0",
  "fingerprints": [
    "5719231201"
  ]
}

client.website.mark_messages_read_in_conversation(website_id, session_id, data);

⭐ Mark Messages As Delivered In Conversation: Reference

client.website.mark_messages_delivered_in_conversation(website_id, session_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

data = {
  "from": "operator",
  "origin": "urn:crisp.im:slack:0",
  "fingerprints": [
    "5719231201"
  ]
}

client.website.mark_messages_delivered_in_conversation(website_id, session_id, data);

⭐ Get Conversation Routing Assign: Reference

client.website.get_conversation_routing_assign(website_id, session_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.get_conversation_routing_assign(website_id, session_id);

⭐ Assign Conversation Routing: Reference

client.website.assign_conversation_routing(website_id, session_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

data = {
  "assigned": {
    "user_id": "a4c32c68-be91-4e29-8a05-976e93abbe3f"
  }
}

client.website.assign_conversation_routing(website_id, session_id, data);

⭐ Get Conversation Metas: Reference

client.website.get_conversation_metas(website_id, session_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.get_conversation_metas(website_id, session_id);

⭐ Update Conversation Metas: Reference

client.website.update_conversation_metas(website_id, session_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

data = {
  "nickname": "John Doe",
  "email": "john.doe@acme-inc.com",
  "segments": [
    "happy",
    "customer",
    "love"
  ],
  "data": {
    "type": "customer",
    "signup": "finished"
  }
}

client.website.update_conversation_metas(website_id, session_id, data);

List Conversation Pages: Reference

client.website.list_conversation_pages(website_id, session_id, page_number)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
page_number = 1

client.website.list_conversation_pages(website_id, session_id, page_number);

List Conversation Events: Reference

client.website.list_conversation_events(website_id, session_id, page_number)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
page_number = 1

client.website.list_conversation_events(website_id, session_id, page_number);

List Conversation Files: Reference

client.website.list_conversation_files(website_id, session_id, page_number)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
page_number = 1

client.website.list_conversation_files(website_id, session_id, page_number);

Get Conversation State: Reference

client.website.get_conversation_state(website_id, session_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.get_conversation_state(website_id, session_id);

⭐ Change Conversation State: Reference

client.website.change_conversation_state(website_id, session_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

data = {"state":"unresolved"}

client.website.change_conversation_state(website_id, session_id, data);

Get Block Status For Conversation: Reference

client.website.get_block_status_for_conversation(website_id, session_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

client.website.get_block_status_for_conversation(website_id, session_id);

Block Incoming Messages For Conversation: Reference

client.website.block_incoming_messages_for_conversation(website_id, session_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

data = true

client.website.block_incoming_messages_for_conversation(website_id, session_id, data);

Request Email Transcript For Conversation: Reference

client.website.request_email_transcript_for_conversation(website_id, session_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
session_id = "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"

data = {
  "to": "operator",
  "email": "valerian@crisp.chat"
}

client.website.request_email_transcript_for_conversation(website_id, session_id, data);

Website People (these are your end-users)

Get People Statistics: Reference

client.website.get_people_statistics(website_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.get_people_statistics(website_id);

List People Segments: Reference

client.website.list_people_segments(website_id, page_number)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
page_number = 1

client.website.list_people_segments(website_id, page_number);

⭐ List People Profiles: Reference

client.website.list_people_profiles(website_id, page_number)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
page_number = 1

client.website.list_people_profiles(website_id, page_number);

⭐ Add New People Profile: Reference

client.website.add_new_people_profile(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = {
  "email": "valerian@crisp.chat",
  "person": {
    "nickname": "Valerian Saliou"
  }
}

client.website.add_new_people_profile(website_id, data);

⭐ Check If People Profile Exists: Reference

client.website.check_people_profile_exists(website_id, people_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
people_id = "c5a2f70c-f605-4648-b47f-8c39d4b03a50"

client.website.check_people_profile_exists(website_id, people_id);

⭐ Get People Profile: Reference

client.website.get_people_profile(website_id, people_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
people_id = "c5a2f70c-f605-4648-b47f-8c39d4b03a50"

client.website.get_people_profile(website_id, people_id);

⭐ Save People Profile: Reference

client.website.save_people_profile(website_id, people_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
people_id = "c5a2f70c-f605-4648-b47f-8c39d4b03a50"

data = {
  "email": "valerian@crisp.chat",
  "person": {
    "nickname": "Valerian Saliou"
  }
}

client.website.save_people_profile(website_id, people_id, data);

⭐ Update People Profile: Reference

client.website.update_people_profile(website_id, people_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
people_id = "c5a2f70c-f605-4648-b47f-8c39d4b03a50"

data = {
  "email": "valerian@crisp.chat",
  "person": {
    "nickname": "Valerian Saliou"
  }
}

client.website.update_people_profile(website_id, people_id, data);

⭐ Remove People Profile: Reference

client.website.remove_people_profile(website_id, people_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
people_id = "c5a2f70c-f605-4648-b47f-8c39d4b03a50"

client.website.remove_people_profile(website_id, people_id);

List People Conversations: Reference

client.website.list_people_conversations(website_id, people_id, page_number)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
people_id = "c5a2f70c-f605-4648-b47f-8c39d4b03a50"
page_number = 1

client.website.list_people_conversations(website_id, people_id, page_number);

Add A People Event: Reference
- client.website.add_people_event(website_id, people_id, data)
List People Events: Reference
- client.website.list_people_events(website_id, people_id, page_number)
Get People Data: Reference
- client.website.get_people_data(website_id, people_id)
Save People Data: Reference
- client.website.save_people_data(website_id, people_id, data)
Get People Subscription Status: Reference
- client.website.get_people_subscription_status(website_id, people_id)
Update People Subscription Status: Reference
- client.website.update_people_subscription_status(website_id, people_id, data)

👉 Notice: The peopleID argument can be an email or the peopleID.

Website Base

Create Website: Reference
- client.website.create_website(data)
- See Example
```
client.website.create_website(data);
```

Get A Website: Reference

client.website.get_website(website_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.get_website(website_id);

Delete A Website: Reference

client.website.delete_website(website_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.delete_website(website_id);

Website Batch

Batch Resolve Items: Reference

client.website.batch_resolve_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.batch_resolve_items(website_id, data);

Batch Unresolve Items: Reference

client.website.batch_unresolve_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = {
  "sessions": [
    "session_19e5240f-0a8d-461e-a661-a3123fc6eec9",
    "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
  ]
}

client.website.batch_unresolve_items(website_id, data);

Batch Read Items: Reference

client.website.batch_read_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.batch_read_items(website_id, data);

Batch Unread Items: Reference

client.website.batch_unread_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = {
  "sessions": [
    "session_19e5240f-0a8d-461e-a661-a3123fc6eec9",
    "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
  ]
}

client.website.batch_unread_items(website_id, data);

Batch Remove Items: Reference

client.website.batch_remove_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = [
  "session_19e5240f-0a8d-461e-a661-a3123fc6eec9",
  "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
]

client.website.batch_remove_items(website_id, data);

Batch Report Items: Reference

client.website.batch_report_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = {
  "sessions": [
    "session_19e5240f-0a8d-461e-a661-a3123fc6eec9",
    "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
  ],
  "flag": "spam"
}

client.website.batch_report_items(website_id, data);

Batch Block Items: Reference

client.website.batch_block_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = {
  "sessions": [
    "session_19e5240f-0a8d-461e-a661-a3123fc6eec9",
    "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
  ],
  "blocked": True
}

client.website.batch_block_items(website_id, data);

Batch Routing Items: Reference

client.website.batch_routing_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = {
  "sessions": [
    "session_19e5240f-0a8d-461e-a661-a3123fc6eec9",
    "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
  ],
  "assigned": {
    "user_id": "a4c32c68-be91-4e29-b97e-b3b6af886eaa"
  }
}

client.website.batch_routing_items(website_id, data);

Batch Inbox Items: Reference

client.website.batch_inbox_items(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = {
  "sessions": [
    "session_19e5240f-0a8d-461e-a661-a3123fc6eec9",
    "session_700c65e1-85e2-465a-b9ac-ecb5ec2c9881"
  ],
  "inbox_id": "d42e8b3b-ea8f-4e79-a9f8-d0e467fc1c31"
}

client.website.batch_inbox_items(website_id, data);

Website Availability
- Get Website Availability Status: Reference
  - client.website.get_website_availability_status(website_id)
  - See Example
```
website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.get_website_availability_status(website_id);
```

Website Operator

List Website Operators: Reference

client.website.list_website_operators(website_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.list_website_operators(website_id);

List Last Active Website Operators: Reference

client.website.list_last_active_website_operators(website_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.list_last_active_website_operators(website_id);

Website Settings

Get Website Settings: Reference

client.website.get_website_settings(website_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.get_website_settings(website_id);

Update Website Settings: Reference

client.website.update_website_settings(website_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

data = {
  "name": "Crisp",
  "domain": "crisp.chat",
  "logo": "https://storage.crisp.chat/users/avatar/website/8c842203-7ed8-4e29-a608-7cf78a7d2fcc/b6c2948d-b061-405e-91a9-2fdf855d1cc0.png",
  "contact": {
    "email": "contact@crisp.chat",
    "phone": "+33757905447"
  },
  "inbox": {
    "lock_removal": false,
    "force_operator_token": false
  },
  "emails": {
    "rating": true,
    "transcript": true,
    "enrich": true,
    "junk_filter": true
  },
  "chatbox": {
    "tile": "default",
    "wait_game": false,
    "last_operator_face": false,
    "ongoing_operator_face": true,
    "activity_metrics": true,
    "operator_privacy": false,
    "availability_tooltip": true,
    "hide_vacation": false,
    "hide_on_away": false,
    "hide_on_mobile": false,
    "position_reverse": false,
    "email_visitors": false,
    "phone_visitors": false,
    "force_identify": false,
    "ignore_privacy": false,
    "visitor_compose": false,
    "file_transfer": true,
    "overlay_search": true,
    "overlay_mode": false,
    "helpdesk_link": true,
    "helpdesk_only": false,
    "status_health_dead": true,
    "check_domain": false,
    "color_theme": "blue",
    "text_theme": "default",
    "welcome_message": "default",
    "locale": "en",
    "allowed_pages": [],
    "blocked_pages": [
      "status/*/",
      "docs.crisp.chat/*",
      "crisp.chat/terms/",
      "https://crisp.chat/privacy/"
    ],
    "blocked_countries": [
      "IT"
    ],
    "blocked_locales": [
      "fa",
      "he"
    ],
    "blocked_ips": [
      "8.8.8.8",
      "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
      "192.168.1.1/24"
    ]
  }
}

client.website.update_website_settings(website_id, data);

Website Visitors

Count Visitors: Reference

client.website.count_visitors(website_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"

client.website.count_visitors(website_id);

List Visitors: Reference

client.website.list_visitors(website_id, page_number)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
page_number = 1

client.website.list_visitors(website_id, page_number);

Plugin

Plugin Connect
- Get Plugin Connect Account: Reference
  - client.plugin.get_connect_account()
  - See Example
```
client.plugin.get_connect_account();
```
- Check Plugin Connect Session Validity: Reference
  - client.plugin.check_connect_session_validity()
  - See Example
```
client.plugin.check_connect_session_validity();
```
- List All Connected Websites: Reference
  - client.plugin.list_all_connect_websites(page_number, filter_configured)
  - See Example
```
page_number = 1

client.plugin.list_all_connect_websites(page_number, filter_configured);
```

Plugin Subscription

List All Active Subscriptions: Reference
- client.plugin.list_all_active_subscriptions()
- See Example
```
client.plugin.list_all_active_subscriptions();
```
List Subscriptions For Website: Reference
- client.plugin.list_subscriptions_website(website_id)

Get Subscription Details: Reference

client.plugin.get_subscription_details(website_id, plugin_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
plugin_id = "c64f3595-adee-425a-8d3a-89d47f7ed6bb"

client.plugin.get_subscription_details(website_id, plugin_id);

Subscribe Website To Plugin: Reference
- client.plugin.subscribe_plugin_to_website(website_id)

Unsubscribe Plugin From Website: Reference

client.plugin.unsubscribe_plugin_from_website(website_id, plugin_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
plugin_id = "c64f3595-adee-425a-8d3a-89d47f7ed6bb"

client.plugin.unsubscribe_plugin_from_website(website_id, plugin_id);

Get Subscription Settings: Reference

client.plugin.get_subscription_settings(website_id, plugin_id)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
plugin_id = "c64f3595-adee-425a-8d3a-89d47f7ed6bb"

client.plugin.get_subscription_settings(website_id, plugin_id);

Save Subscription Settings: Reference

client.plugin.save_subscription_settings(website_id, plugin_id, settings)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
plugin_id = "c64f3595-adee-425a-8d3a-89d47f7ed6bb"

settings = {
  "chatbox": {
    "25": "#bbbbbb"
  }
}

client.plugin.save_subscription_settings(website_id, plugin_id, settings);

Update Subscription Settings: Reference

client.plugin.update_subscription_settings(website_id, plugin_id, settings)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
plugin_id = "c64f3595-adee-425a-8d3a-89d47f7ed6bb"

settings = {
  "chatbox": {
    "25": "#bbbbbb"
  }
}

client.plugin.update_subscription_settings(website_id, plugin_id, settings);

Forward Plugin Payload To Channel: Reference

client.plugin.forward_plugin_payload_to_channel(website_id, plugin_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
plugin_id = "c64f3595-adee-425a-8d3a-89d47f7ed6bb"

data = {
  "namespace": "bot:step",
  "payload": {
    "step": 1
  }
}

client.plugin.forward_plugin_payload_to_channel(website_id, plugin_id, data);

Dispatch Plugin Event: Reference

client.plugin.dispatch_plugin_event(website_id, plugin_id, data)

See Example

website_id = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
plugin_id = "c64f3595-adee-425a-8d3a-89d47f7ed6bb"

data = {
  "name": "bot-is-running",
  "data": {
    "bot": "Sales",
    "email": "valerian@crisp.chat"
  }
}

client.plugin.dispatch_plugin_event(website_id, plugin_id, data);

Bucket

Bucket URL
- Generate Bucket URL: Reference
  - client.bucket.generate_bucket_url(data)
  - See Example
```
client.bucket.generate_bucket_url(data);
```

Project details

These details have not been verified by PyPI

Project links

Homepage

Environment
- Web Environment
Intended Audience
- Developers
Natural Language
- English
Programming Language
- Python

Release history Release notifications | RSS feed

1.1.22

May 29, 2026

This version

1.1.21

May 14, 2026

1.1.19

Nov 6, 2023

1.1.18

Jan 16, 2023

1.1.17

Jan 6, 2023

1.1.16

Jan 6, 2023

1.1.15

Jan 6, 2023

1.1.14

Jan 4, 2023

1.1.13

Nov 10, 2022

1.1.10

Jul 20, 2021

1.1.9

Jun 28, 2021

1.1.8

May 6, 2021

1.1.7

Apr 20, 2021

1.1.6

Mar 23, 2021

1.1.5

Mar 18, 2021

1.1.4

Nov 10, 2020

1.1.3

Jun 4, 2020

1.1.1

Feb 24, 2019

1.1.0

Aug 15, 2018

1.0.6

Jul 13, 2018

1.0.5

May 4, 2018

1.0.4

Jan 25, 2018

1.0.3

Jan 25, 2018

1.0.2

Jan 4, 2018

1.0.1

Jan 4, 2018

1.0.0

Jan 4, 2018

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

crisp_api-1.1.21.tar.gz (22.2 kB view details)

Uploaded May 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

crisp_api-1.1.21-py3-none-any.whl (12.8 kB view details)

Uploaded May 14, 2026 Python 3

File details

Details for the file crisp_api-1.1.21.tar.gz.

File metadata

Download URL: crisp_api-1.1.21.tar.gz
Upload date: May 14, 2026
Size: 22.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.10.20

File hashes

Hashes for crisp_api-1.1.21.tar.gz
Algorithm	Hash digest
SHA256	`0b8ba757f50adac5ae02a7172396f2fe59aa0900c369cd11b0658c5ec48184a4`
MD5	`9cb6e7ed780a22be2a915849907f53e8`
BLAKE2b-256	`c9f4dfd9bbdce475b0d907a932fc69ce123f85cedd93e827ba252ed62dbfd84c`

See more details on using hashes here.

File details

Details for the file crisp_api-1.1.21-py3-none-any.whl.

File metadata

Download URL: crisp_api-1.1.21-py3-none-any.whl
Upload date: May 14, 2026
Size: 12.8 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.10.20

File hashes

Hashes for crisp_api-1.1.21-py3-none-any.whl
Algorithm	Hash digest
SHA256	`282fc323d7c06f3e51f1ee889a2a86e03f1568c9bc74f0b96219eaa864ba101c`
MD5	`915d6716ee671a5bd56a0f3957d006fc`
BLAKE2b-256	`ccdbacd7ce60ab2c1ef47e339d5a61ea12fb93d044838659b986ed1e04589fc2`

See more details on using hashes here.

crisp-api 1.1.21

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Crisp API Wrapper

Usage

Authentication

Resource Methods

Website

Plugin

Bucket

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes