Metadata-Version: 2.1
Name: fb_waba_manager
Version: 0.0.5
Summary: Helper to handle with facebook's waba
Home-page: https://github.com/chr0m1ng/fb-waba-manager
Author: Gabriel Rodrigues dos Santos
Author-email: gabrielr@take.net
License: MIT
Description: # Facebook Whatsapp Business Account Manager
        
        Handle some facebook whatsapp business account manager functionalities.
        
        **FYI**: `waba` stands for WhatsApp Business Account
        
        ## Usage
        
        ### Constructor
        
        ```python
        from fb_waba_manager import FbWabaManager
        
        access_token = 'my_access_token'
        business_id = 'my_business_id'
        
        fwm = FbWabaManager(access_token, business_id)
        ```
        
        ### Methods
        
        The following methods are provided:
        
        Ps.: All methods are **generators**.
        
        #### list_business_wabas
        
        Retrieve a list of all `waba objects` of your `business`
        
        ```python
        for w in fwm.list_business_wabas():
          print(w)
        
        # Example of a waba object:
        # {
        #   'id': '21312312321',
        #   'name': 'Some name',
        #   'currency': 'USD',
        #   'timezone_id': '25',
        #   'business_type': 'ent',
        #   'message_template_namespace': 'gafsdf_2132_213_asd'
        # }
        ```
        
        ---
        
        #### list_waba_phone_numbers
        
        Retrieve a list of all `phone number objects` of your `waba`
        
        | Parameters | Type  |
        |------------|-------|
        | waba_id    | `str` |
        
        ```python
        waba_id = '1231434'
        
        for pn in fwm.list_waba_phone_numbers(waba_id):
          print(pn)
        
        # Example of a phone number object:
        # {
        #   'verified_name': 'My number name',
        #   'display_phone_number': '+55 73 1234-5678',
        #   'quality_rating': 'GREEN',
        #   'thread_limit_per_day': 1000,
        #   'id': '132354254546'
        # }
        ```
        
        ---
        
        #### list_business_phone_numbers
        
        Retrieve a list of all `phone number objects` of all `wabas` of your `business`
        
        | Parameters | Type              |
        |------------|-------------------|
        | wabas      | `list` (optional) |
        
        ```python
        
        for pn in fwm.list_business_phone_numbers():
          print(pn)
        
        # You can pass a list of wabas
        # the objects must have at least the id key
        
        my_wabas = [
          {
            'id': '12342443'
          },
          {
            'id': '56355465'
          }
        ]
        
        for pn in fwm.list_business_phone_numbers(my_wabas):
          print(pn)
        ```
        
        #### list_message_templates
        
        Retrieve a list of all `message templates objects` of your `waba`
        
        | Parameters | Type  |
        |------------|-------|
        | waba_id    | `str` |
        
        ```python
        waba_id = '1231434'
        
        for mt in fwm.list_message_templates(waba_id):
          print(mt)
        
        # Example of a phone number object:
        # {
        #     "name": "my_message_template_name",
        #     "components": [
        #         {
        #             "type": "BODY",
        #             "text": "Obrigado pelo contato, at\u00e9 a pr\u00f3xima.\\n\\n:)"
        #         }
        #     ],
        #     "language": "pt_BR",
        #     "status": "APPROVED",
        #     "category": "ACCOUNT_UPDATE",
        #     "id": "16453353"
        # }
        ```
        
        ---
        
        ### Reference
        
        The `waba`, `business`, `phone number` and `message template` definition or properties can be found at [Facebook's oficial documentation](https://developers.facebook.com/docs/whatsapp/business-management-api)
        
Keywords: facebook,graph api,waba
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
