Channel APIs

Overview

The following APIs help you manage contact data and active conversations for your teams and channels.

1. Get Channel

Get Channel by channel type (web, whatsapp, facebook, wechat, etc.).

  • Endpoint for Product: GET https://app-gateway.imbrace.co/v1/backend/channels?type=web

  • Endpoint for Demo: GET https://app-gateway.demo.imbrace.co/v1/backend/channels?type=web

  • Endpoint for Dev: GET https://app-gateway.dev.imbrace.co/v1/backend/channels?type=web

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

    {
        "data": [
            {
                "_id": "ch_a085c890-6932-4451-a0e2-291c28184355",
                "doc_name": "channel",
                "name": "WhatsApp 112",
                "active": false,
                "is_deleted": false,
                "bot_id": "u_imbrace_bot",
                "business_unit_id": "bu_imbrace_testing",
                "organization_id": "org_imbrace",
                "config": {
                    "access_key": "afeafff12134123412",
                    "phone_number": "123312224",
                    "phone_number_id": "afe34234",
                    "business_account_id": "afae34234r23",
                    "namespace": null,
                    "signing_key": null,
                    "use_facebook_login": false,
                    "_id": "65ddb97ec6825e4402c6275c",
                    "type": "whatsapp"
                },
                "public_id": "ch_a085c890-6932-4451-a0e2-291c28184355",
                "created_at": "2024-02-27T10:29:18.947Z",
                "credential_id": "1181",
                "updated_at": "2024-02-27T10:29:19.283Z",
                "workflow_id": "2345",
                "is_init": false,
                "touchpoints": [],
                "id": "ch_a085c890-6932-4451-a0e2-291c28184355"
            },
            {
                "_id": "ch_e5c57300-c218-4b59-bcc3-74dd2c45e119",
                "doc_name": "channel",
                "name": "WhatsApp 10 test old",
                "active": false,
                "is_deleted": false,
                "bot_id": "u_imbrace_bot",
                "business_unit_id": "bu_imbrace_testing",
                "organization_id": "org_imbrace",
                "config": {
                    "access_key": "111111111111111111111updated",
                    "phone_number": "111111111111111updated",
                    "phone_number_id": "111111111111111111updated",
                    "business_account_id": "11111111111111111111updated",
                    "namespace": null,
                    "signing_key": null,
                    "use_facebook_login": false,
                    "_id": "65c31ac9085dd896c86ce848",
                    "type": "whatsapp"
                },
                "public_id": "ch_e5c57300-c218-4b59-bcc3-74dd2c45e119",
                "created_at": "2024-01-22T03:29:59.248Z",
                "credential_id": "1094",
                "updated_at": "2024-01-22T03:29:59.708Z",
                "workflow_id": "1880",
                "is_init": false,
                "touchpoints": [
                    {
                        "_id": "tp_330e3ec4-34ea-4dc1-aec6-1e7a75ff9ea9",
                        "doc_name": "touchpoints",
                        "business_unit_id": "bu_imbrace_testing",
                        "organization_id": "org_imbrace",
                        "channel_id": "ch_e5c57300-c218-4b59-bcc3-74dd2c45e119",
                        "default_channel_workflow_id": "1880",
                        "scan_qrcode_count": 0,
                        "from_url_count": 0,
                        "url": "",
                        "name": "My Touchpoint 249",
                        "start_datetime": "2024-01-24T16:00:00.000Z",
                        "end_datetime": null,
                        "destination_url": "",
                        "execute_workflow_id": "1880",
                        "logo": "",
                        "media_name": "",
                        "description": "",
                        "deleted_at": null,
                        "is_archived": false,
                        "is_paused": false,
                        "public_id": "tp_330e3ec4-34ea-4dc1-aec6-1e7a75ff9ea9",
                        "created_at": "2024-01-25T07:50:22.637Z"
                    }
                ],
                "id": "ch_e5c57300-c218-4b59-bcc3-74dd2c45e119"
            }
        ]
    }
  • Example:

    curl --location 'https://app-gateway.dev.imbrace.co/v1/channels?type=whatsapp' \
    --header 'X-Access-Token: acc_f7124766-e633-429c-b24a-ab0421a202e3'

2. Get count all channel

  • Endpoint for Product: GET https://app-gateway.imbrace.co/v1/backend/channels/_count

  • Endpoint for Demo: GET https://app-gateway.demo.imbrace.co/v1/backend/channels/_count

  • Endpoint for Dev: GET https://app-gateway.dev.imbrace.co/v1/backend/channels/_count

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

  • Example:

3. Get processed credential types

  • Endpoint for Product: GET https://app-gateway.imbrace.co/v1/backend/workflow/processed-credential-types

  • Endpoint for Demo: GET https://app-gateway.demo.imbrace.co/v1/backend/workflow/processed-credential-types

  • Endpoint for Dev: GET https://app-gateway.dev.imbrace.co/v1/backend/workflow/processed-credential-types

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

  • Example:

4. Create channel webwidget

Dismisses (removes) specific notifications from the user’s list. This is typically a soft delete from the client’s perspective. Use when the user explicitly dismisses one or multiple notifications (e.g., “Clear” button on an item).

  • Endpoint for Product: POST https://app-gateway.imbrace.co/v3/backend/channels/_web

  • Endpoint for Demo: POST https://app-gateway.demo.imbrace.co/v3/backend/channels/_web

  • Endpoint for Dev: POST https://app-gateway.dev.imbrace.co/v3/backend/channels/_web

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

  • Example:

5. Get channel by channel ID

  • Endpoint for Product: GET https://app-gateway.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Endpoint for Demo: GET https://app-gateway.demo.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Endpoint for Dev: GET https://app-gateway.dev.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

  • Example:

6. Active channel webwidget

  • Endpoint for Product: PUT https://app-gateway.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Endpoint for Demo: PUT https://app-gateway.demo.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Endpoint for Dev: PUT https://app-gateway.dev.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

  • Example:

7. Setup channel webwidget

  • Endpoint for Product: PUT https://app-gateway.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Endpoint for Demo: PUT https://app-gateway.demo.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Endpoint for Dev: PUT https://app-gateway.dev.imbrace.co/v1/backend/channels/ch_38a02d56-f2ca-484a-b422-186b0f360b9e

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

  • Example:

8. Create channel whatsApp

  • Endpoint for Product: POST https://app-gateway.imbrace.co/v1/backend/channels/_whatsapp

  • Endpoint for Demo: POST https://app-gateway.demo.imbrace.co/v1/backend/channels/_whatsapp

  • Endpoint for Dev: POST https://app-gateway.dev.imbrace.co/v1/backend/channels/_whatsapp

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

  • Example:

9. Update whatsApp channel

  • Endpoint for Product: PUT https://app-gateway.imbrace.co/v1/backend/channels/_whatsapp

  • Endpoint for Demo: PUT https://app-gateway.demo.imbrace.co/v1/backend/channels/_whatsapp

  • Endpoint for Dev: PUT https://app-gateway.dev.imbrace.co/v1/backend/channels/_whatsapp

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

    • Status code: 400 Bad Request

  • Example:

10. Create facebook channel

  • Endpoint for Product: POST https://app-gateway.imbrace.co/v1/backend/channels/_facebook

  • Endpoint for Demo: POST https://app-gateway.demo.imbrace.co/v1/backend/channels/_facebook

  • Endpoint for Dev: POST https://app-gateway.dev.imbrace.co/v1/backend/channels/_facebook

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access TokenYour Access Token

  • Body:

  • Result:

    • Status code: 200 OK

    • Status code: 403 Forbidden

    • Status code: 400 Bad Request

    • Status code: 500 Internal Server Error

  • Example:

11. Update Facebook channel

  • Endpoint for Product: PUT https://app-gateway.imbrace.co/v1/backend/channels/_facebook

  • Endpoint for Demo: PUT https://app-gateway.demo.imbrace.co/v1/backend/channels/_facebook

  • Endpoint for Dev: PUT https://app-gateway.dev.imbrace.co/v1/backend/channels/_facebook

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access Token

  • Body:

  • Result:

    • Status code: 200 OK

    • Status code: 400 Bad Request

  • Example:

12. Delete channel

  • Endpoint for Product: DELETE https://app-gateway.imbrace.co/v1/backend/channels/:id

  • Endpoint for Demo: DELETE https://app-gateway.demo.imbrace.co/v1/backend/channels/:id

  • Endpoint for Dev: DELETE https://app-gateway.dev.imbrace.co/v1/backend/channels/:id

  • Headers:

    • Content-Type: application/json

    • x-access-token: Your Access Token

  • Params (Path Variables):

    • id: ch_7666c70b-b8ca-4425-8052-adc712a8f3bd

  • Body:

  • Result:

    • Status code: 200 OK

    • Status code: 404 Not Found

  • Example:

Last updated