sendbee-api 1.7.0__tar.gz → 1.8.0__tar.gz

{sendbee_api-1.7.0/sendbee_api.egg-info → sendbee_api-1.8.0}/PKG-INFO

@@ -1,14 +1,12 @@
-Metadata-Version: 2.1
-Name: sendbee-api
-Version: 1.7.0
+Metadata-Version: 2.4
+Name: sendbee_api
+Version: 1.8.0
 Summary: Python client SDK for Sendbee Public API
-Home-page: https://github.com/sendbee/sendbee-python-client
-Author: Sendbee ltd
-Author-email: info@sendbee.io
+Author-email: Sendbee ltd <info@sendbee.io>
 License: MIT
+Project-URL: Homepage, https://github.com/sendbee/sendbee-python-client
 Project-URL: Source, https://github.com/sendbee/sendbee-python-client
-Keywords: sendbee api python
-Platform: UNKNOWN
+Keywords: sendbee,api,python
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: License :: OSI Approved :: MIT License
@@ -16,30 +14,32 @@ Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
-
-# Sendbee Python API Client  
-
-```
-
-                .' '.            __
-       .        .   .           (__\_
-        .         .         . -{{_(|8)
-          ' .  . ' ' .  . '     (__/
-
-```  
+Requires-Dist: click>=7.0
+Requires-Dist: requests>=2.20.0
+Requires-Dist: dumpit>=0.5.0
+Requires-Dist: aenum>=2.1.2
+Requires-Dist: ujson<6,>=5.7.0
+Requires-Dist: cryptography>=3.2
+Requires-Dist: curlify>=2.2.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: responses>=0.23; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="docs/images/number-logo-tm.png" alt="AI Number">
+</p>
+
+# AI Number Python API Client  
 
 [![PyPI version](https://badge.fury.io/py/sendbee-api.svg)](https://badge.fury.io/py/sendbee-api)
-[![Build Status](https://travis-ci.org/sendbee/sendbee-python-api-client.svg?branch=master)](https://travis-ci.org/sendbee/sendbee-python-api-client)
-
-![GitHub issues](https://img.shields.io/github/issues/sendbee/sendbee-python-api-client.svg)
-![GitHub closed issues](https://img.shields.io/github/issues-closed/sendbee/sendbee-python-api-client.svg)
-![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/sendbee/sendbee-python-api-client.svg)
-
-![PyPI - Python Version](https://img.shields.io/pypi/pyversions/sendbee-api.svg)
-![GitHub](https://img.shields.io/github/license/sendbee/sendbee-python-api-client.svg?color=blue)
-![GitHub last commit](https://img.shields.io/github/last-commit/sendbee/sendbee-python-api-client.svg?color=blue)
 
 ## Table of contents  
 
@@ -84,6 +84,10 @@ License-File: LICENSE
 -   [Managing chatbot (automated responses) status settings](#bot-on-off)  
 -   [Get chatbot (automated responses) status](#bot-status)  
 
+#### Webhooks  
+
+-   [Subscribe to webhook](#subscribe-webhook)  
+
 #### Mics  
 
 -   [Pagination](#pagination)
@@ -561,6 +565,59 @@ response.chatbot_active # True/False
 
 ```
 
+## Webhooks  
+
+### <a href='#subscribe-webhook'>Subscribe to webhook</a>
+
+Register a URL of yours and subscribe it to a webhook event, so we start sending
+you requests when that event happens. This does the same thing as activating a
+webhook URL in the Sendbee Dashboard.  
+
+```python
+webhook = api.subscribe_webhook(
+    url='https://example.com/sendbee/webhook',
+    event='message.received'
+)
+
+webhook.id                 # UUID of the webhook endpoint
+webhook.url                # the URL you registered
+webhook.active             # True/False
+webhook.selected_webhooks  # list of all events this URL is subscribed to
+webhook.secret_key         # key used to sign requests we send to your URL
+webhook.created_at
+```
+
+Both `url` and `event` are required. Calling it again for the same `url` is safe -
+it will not create a duplicate, it just adds the new event to that URL (and
+re-activates it if it was deactivated), so subscribe one event per call:  
+
+```python
+for event in ('message.received', 'message.sent'):
+    api.subscribe_webhook(url='https://example.com/sendbee/webhook', event=event)
+```
+
+Available events:  
+
+| Event | Description |
+| --- | --- |
+| `contact.created` | A new contact was created |
+| `contact.subscription_created` | A contact subscribed |
+| `contact.subscription_updated` | A contact's subscription changed |
+| `contact.unsubscribed` | A contact unsubscribed |
+| `message.received` | A message was received from a contact |
+| `message.sent` | A message was sent to a contact |
+| `message.sent_status` | Delivery status of a sent message changed |
+| `whatsapp.message.session.sent_status` | Delivery status of a session message changed |
+| `whatsapp.message.template.sent_status` | Delivery status of a template message changed |
+| `whatsapp.message.template.approval_status` | A message template was approved or rejected |
+| `conversation.change_folder` | A conversation was moved to another folder |
+
+An unknown event name returns a `SendbeeRequestApiException`. For the authoritative
+and up to date list, see the [documentation](https://developer.ainumber.com/#webhooks).  
+
+Once subscribed, see [Authenticate webhook request](#authenticate-webhook-request)
+for how to verify the requests we send you.  
+
 ## Misc  
 
 ### <a href='#pagination'>Pagination</a>
@@ -646,7 +703,7 @@ except SendbeeRequestApiException as e:
 
 ### <a href='#authenticate-webhook-request'>Authenticate webhook request</a>
 
-After activating your webhook URL in Sendbee Dashboard, we will start sending requests on that URL depending on which webhook type is linked with that webhook URL.  
+After activating your webhook URL in Sendbee Dashboard or with [Subscribe to webhook](#subscribe-webhook), we will start sending requests on that URL depending on which webhook type is linked with that webhook URL.  
 Every request that we make will have authorization token in header, like this:  
 
 ```
@@ -669,9 +726,24 @@ if not api.auth.check_auth_token(token):
     # error! authentication failed!
 ```  
 
+Requests to a webhook URL that has its own secret key also carry a second header,
+`X-Auth-Token`, signed with that key instead of your account secret. You get the
+key back as `webhook.secret_key` from [Subscribe to webhook](#subscribe-webhook).
+Check it the same way, using `SendbeeAuth` directly:  
+
+```python
+from sendbee_api import SendbeeAuth
+
+secret_key = '...'  # webhook.secret_key, store it when you subscribe
+
+token = '...'  # taken from the 'X-Auth-Token' request header
+if not SendbeeAuth(secret_key).check_auth_token(token):
+    # error! authentication failed!
+```  
+
 ### <a href='#warnings'>Warnings</a>
 
-Sometimes APi returns a worning so you could be warned about something.  
+Sometimes APi returns a warning so you could be warned about something.  
 The waning is displayed in standard output:  
 
 ![Debugging](docs/images/warning.png)  
@@ -692,5 +764,3 @@ api = SendbeeApi(
 Once you enabled the internal debug tool, every request to API will output various request and response data in standard output:  
 
 ![Debugging](docs/images/debugging.png)   
-
-

sendbee_api-1.7.0/PKG-INFO → sendbee_api-1.8.0/README.md

@@ -1,45 +1,10 @@
-Metadata-Version: 2.1
-Name: sendbee_api
-Version: 1.7.0
-Summary: Python client SDK for Sendbee Public API
-Home-page: https://github.com/sendbee/sendbee-python-client
-Author: Sendbee ltd
-Author-email: info@sendbee.io
-License: MIT
-Project-URL: Source, https://github.com/sendbee/sendbee-python-client
-Keywords: sendbee api python
-Platform: UNKNOWN
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-# Sendbee Python API Client  
+<p align="center">
+  <img src="docs/images/number-logo-tm.png" alt="AI Number">
+</p>
 
-```
-
-                .' '.            __
-       .        .   .           (__\_
-        .         .         . -{{_(|8)
-          ' .  . ' ' .  . '     (__/
-
-```  
+# AI Number Python API Client  
 
 [![PyPI version](https://badge.fury.io/py/sendbee-api.svg)](https://badge.fury.io/py/sendbee-api)
-[![Build Status](https://travis-ci.org/sendbee/sendbee-python-api-client.svg?branch=master)](https://travis-ci.org/sendbee/sendbee-python-api-client)
-
-![GitHub issues](https://img.shields.io/github/issues/sendbee/sendbee-python-api-client.svg)
-![GitHub closed issues](https://img.shields.io/github/issues-closed/sendbee/sendbee-python-api-client.svg)
-![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/sendbee/sendbee-python-api-client.svg)
-
-![PyPI - Python Version](https://img.shields.io/pypi/pyversions/sendbee-api.svg)
-![GitHub](https://img.shields.io/github/license/sendbee/sendbee-python-api-client.svg?color=blue)
-![GitHub last commit](https://img.shields.io/github/last-commit/sendbee/sendbee-python-api-client.svg?color=blue)
 
 ## Table of contents  
 
@@ -84,6 +49,10 @@ License-File: LICENSE
 -   [Managing chatbot (automated responses) status settings](#bot-on-off)  
 -   [Get chatbot (automated responses) status](#bot-status)  
 
+#### Webhooks  
+
+-   [Subscribe to webhook](#subscribe-webhook)  
+
 #### Mics  
 
 -   [Pagination](#pagination)
@@ -561,6 +530,59 @@ response.chatbot_active # True/False
 
 ```
 
+## Webhooks  
+
+### <a href='#subscribe-webhook'>Subscribe to webhook</a>
+
+Register a URL of yours and subscribe it to a webhook event, so we start sending
+you requests when that event happens. This does the same thing as activating a
+webhook URL in the Sendbee Dashboard.  
+
+```python
+webhook = api.subscribe_webhook(
+    url='https://example.com/sendbee/webhook',
+    event='message.received'
+)
+
+webhook.id                 # UUID of the webhook endpoint
+webhook.url                # the URL you registered
+webhook.active             # True/False
+webhook.selected_webhooks  # list of all events this URL is subscribed to
+webhook.secret_key         # key used to sign requests we send to your URL
+webhook.created_at
+```
+
+Both `url` and `event` are required. Calling it again for the same `url` is safe -
+it will not create a duplicate, it just adds the new event to that URL (and
+re-activates it if it was deactivated), so subscribe one event per call:  
+
+```python
+for event in ('message.received', 'message.sent'):
+    api.subscribe_webhook(url='https://example.com/sendbee/webhook', event=event)
+```
+
+Available events:  
+
+| Event | Description |
+| --- | --- |
+| `contact.created` | A new contact was created |
+| `contact.subscription_created` | A contact subscribed |
+| `contact.subscription_updated` | A contact's subscription changed |
+| `contact.unsubscribed` | A contact unsubscribed |
+| `message.received` | A message was received from a contact |
+| `message.sent` | A message was sent to a contact |
+| `message.sent_status` | Delivery status of a sent message changed |
+| `whatsapp.message.session.sent_status` | Delivery status of a session message changed |
+| `whatsapp.message.template.sent_status` | Delivery status of a template message changed |
+| `whatsapp.message.template.approval_status` | A message template was approved or rejected |
+| `conversation.change_folder` | A conversation was moved to another folder |
+
+An unknown event name returns a `SendbeeRequestApiException`. For the authoritative
+and up to date list, see the [documentation](https://developer.ainumber.com/#webhooks).  
+
+Once subscribed, see [Authenticate webhook request](#authenticate-webhook-request)
+for how to verify the requests we send you.  
+
 ## Misc  
 
 ### <a href='#pagination'>Pagination</a>
@@ -646,7 +668,7 @@ except SendbeeRequestApiException as e:
 
 ### <a href='#authenticate-webhook-request'>Authenticate webhook request</a>
 
-After activating your webhook URL in Sendbee Dashboard, we will start sending requests on that URL depending on which webhook type is linked with that webhook URL.  
+After activating your webhook URL in Sendbee Dashboard or with [Subscribe to webhook](#subscribe-webhook), we will start sending requests on that URL depending on which webhook type is linked with that webhook URL.  
 Every request that we make will have authorization token in header, like this:  
 
 ```
@@ -669,9 +691,24 @@ if not api.auth.check_auth_token(token):
     # error! authentication failed!
 ```  
 
+Requests to a webhook URL that has its own secret key also carry a second header,
+`X-Auth-Token`, signed with that key instead of your account secret. You get the
+key back as `webhook.secret_key` from [Subscribe to webhook](#subscribe-webhook).
+Check it the same way, using `SendbeeAuth` directly:  
+
+```python
+from sendbee_api import SendbeeAuth
+
+secret_key = '...'  # webhook.secret_key, store it when you subscribe
+
+token = '...'  # taken from the 'X-Auth-Token' request header
+if not SendbeeAuth(secret_key).check_auth_token(token):
+    # error! authentication failed!
+```  
+
 ### <a href='#warnings'>Warnings</a>
 
-Sometimes APi returns a worning so you could be warned about something.  
+Sometimes APi returns a warning so you could be warned about something.  
 The waning is displayed in standard output:  
 
 ![Debugging](docs/images/warning.png)  
@@ -692,5 +729,3 @@ api = SendbeeApi(
 Once you enabled the internal debug tool, every request to API will output various request and response data in standard output:  
 
 ![Debugging](docs/images/debugging.png)   
-
-

sendbee_api-1.8.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sendbee_api"
+version = "1.8.0"
+description = "Python client SDK for Sendbee Public API"
+readme = "README.md"
+requires-python = ">=3.6"
+license = { text = "MIT" }
+authors = [{ name = "Sendbee ltd", email = "info@sendbee.io" }]
+keywords = ["sendbee", "api", "python"]
+classifiers = [
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Build Tools",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "click>=7.0",
+    "requests>=2.20.0",
+    "dumpit>=0.5.0",
+    "aenum>=2.1.2",
+    "ujson>=5.7.0,<6",
+    "cryptography>=3.2",
+    "curlify>=2.2.1",
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "responses>=0.23"]
+
+[project.urls]
+Homepage = "https://github.com/sendbee/sendbee-python-client"
+Source = "https://github.com/sendbee/sendbee-python-client"
+
+[tool.setuptools.packages.find]
+include = ["sendbee_api*"]
+exclude = ["tests*"]

{sendbee_api-1.7.0 → sendbee_api-1.8.0}/sendbee_api/bind.py

@@ -190,6 +190,10 @@ def bind_request(**request_data):
                     self.parameters[constants.RequestConst.QUERY]
                 )
                 self.debug.ok(constants.ResponseConst.RESPONSE_OBJECT, response)
+                self.debug.set_curl(
+                    constants.DebugConst.CURL,
+                    response.request
+                )
 
                 return response.status_code, response.headers, response.text
 
@@ -213,7 +217,13 @@ def bind_request(**request_data):
                 self.debug.ok('payload', self.parameters[
                     constants.RequestConst.QUERY
                 ])
-                self.debug.ok(constants.ResponseConst.RESPONSE_OBJECT, response)
+                self.debug.ok(
+                    constants.ResponseConst.RESPONSE_OBJECT, response
+                )
+                self.debug.set_curl(
+                    constants.DebugConst.CURL,
+                    response.request
+                )
 
                 return response.status_code, response.headers, response.text
 

{sendbee_api-1.7.0 → sendbee_api-1.8.0}/sendbee_api/client.py

@@ -3,13 +3,14 @@ import click
 from sendbee_api.auth import SendbeeAuth
 from sendbee_api.teams.client import Teams
 from sendbee_api.contacts.client import Contacts
+from sendbee_api.webhooks.client import Webhooks
 from sendbee_api.rate_limit.client import RateLimit
 from sendbee_api.automation.client import Automation
 from sendbee_api.conversations.client import Messages
 from sendbee_api.exceptions import SendbeeRequestApiException
 
 
-class Client(Contacts, Messages, Automation, Teams, RateLimit):
+class Client(Contacts, Messages, Automation, Teams, Webhooks, RateLimit):
     """Main API class. Sets all API calls."""
 
     base_url = 'api-v2.sendbee.io'

{sendbee_api-1.7.0 → sendbee_api-1.8.0}/sendbee_api/constants.py

@@ -1,3 +1,4 @@
+from abc import ABCMeta
 from collections import namedtuple
 
 
@@ -64,3 +65,23 @@ ResponseDataConst = namedtuple(
     'ResponseDataConst', ['DATA', 'META']
 )('data', 'meta')
 
+
+class ConstMeta(ABCMeta):
+    def __setattr__(self, name, value):
+        pass
+
+
+class Const(metaclass=ConstMeta):
+    """Helper class """
+    __slots__ = ()
+
+
+class DebugConst(Const):
+    PARAMETERS = 'parameters'
+    RESPONSE = 'response'
+    STATUS_CODE = 'status code'
+    FINAL_URL = 'final url'
+    HEADERS = 'headers'
+    METHOD = 'method'
+    QUERY_PARAMETERS = 'query parameters'
+    CURL = 'curl'

{sendbee_api-1.7.0 → sendbee_api-1.8.0}/sendbee_api/conversations/models.py

@@ -41,6 +41,8 @@ class SentMessage(Model):
 
     _conversation_id = TextField(index='id', desc='Conversation UUID')
     _message_id = TextField(index='message_id', desc='Message UUID')
+    _message_reference_id = TextField(index='message_reference_id',
+                                      desc='Message Reference UUID')
     _status = TextField(index='status', desc='Message status')
 
 

{sendbee_api-1.7.0 → sendbee_api-1.8.0}/sendbee_api/conversations/query_params.py

@@ -21,6 +21,7 @@ class SendTemplateMessage(QueryParams):
     prevent_bot_off = 'prevent_bot_off', 'Prevent turning-off chatbot'
     agent_id = 'agent_id', 'Assigned agent for the conversation'
     attachment = 'attachment', 'Attachment URL for media templates'
+    live_inbox = 'live_inbox', 'Trigger real-time events after sending'
 
 
 class SendMessage(QueryParams):
@@ -31,6 +32,7 @@ class SendMessage(QueryParams):
     media_url = 'media_url', 'Media URL for media message'
     prevent_bot_off = 'prevent_bot_off', 'Prevent turning-off chatbot'
     agent_id = 'agent_id', 'Assigned agent for the conversation'
+    live_inbox = 'live_inbox', 'Trigger real-time events after sending'
 
 
 class ListConversations(QueryParams):

{sendbee_api-1.7.0 → sendbee_api-1.8.0}/sendbee_api/debug.py

@@ -1,5 +1,5 @@
 import click
-import pprint
+import curlify
 
 
 STATUS_OK = 'ok'
@@ -25,6 +25,13 @@ class Debug:
     def error(self, key, value):
         self.record(key, value, STATUS_ERROR)
 
+    def set_curl(self, key, request):
+        if self.client.debug:
+            try:
+                self.ok(key, curlify.to_curl(request, compressed=False))
+            except UnicodeDecodeError:
+                self.ok(key, '__unable_to_decode__')
+
     def record(self, key, value, status):
         if self.client.debug:
             self.recorded_data[key] = {'value': value, 'status': status}

sendbee_api-1.8.0/sendbee_api/webhooks/client.py

@@ -0,0 +1,16 @@
+from sendbee_api import constants
+from sendbee_api.webhooks import models
+from sendbee_api.bind import bind_request
+from sendbee_api.webhooks import query_params
+
+
+class Webhooks:
+    """Api client for webhooks"""
+
+    subscribe_webhook = bind_request(
+        api_path='/webhooks/subscribe',
+        model=models.Webhook,
+        method=constants.RequestConst.POST,
+        query_parameters=query_params.SubscribeWebhook,
+        description='Api client for subscribing to a webhook event'
+    )

sendbee_api-1.8.0/sendbee_api/webhooks/models.py

@@ -0,0 +1,22 @@
+from sendbee_api.models import Model
+from sendbee_api.fields import (
+    TextField, BooleanField, DatetimeField, ListField
+)
+
+
+class Webhook(Model):
+    """Data model for a webhook endpoint subscription"""
+
+    _id = TextField(index='id', desc='UUID')
+    _url = TextField(index='url', desc='Webhook endpoint URL')
+    _active = BooleanField(index='active', desc='Is the endpoint active')
+    _secret_key = TextField(
+        index='secret_key',
+        desc='Key that signs the X-Auth-Token header on inbound webhooks'
+    )
+    _selected_webhooks = ListField(
+        index='selected_webhooks', desc='Subscribed webhook event names'
+    )
+    _created_at = DatetimeField(
+        index='created_at', desc='Created at', format='%Y-%m-%d %H:%M:%'
+    )

sendbee_api-1.8.0/sendbee_api/webhooks/query_params.py

@@ -0,0 +1,9 @@
+from sendbee_api.query_params import QueryParams
+
+
+class SubscribeWebhook(QueryParams):
+    """Parameters for subscribing to a webhook event"""
+
+    url = 'url', 'Webhook endpoint URL that will receive the events'
+    event = 'event', 'Webhook event name, e.g. "message.received". ' \
+                     'See https://developer.ainumber.com/#webhooks'