Working with Facebook Accounts

Businesses need to connect their Facebook page to their WhatsApp Business API accounts to use it in Facebook resources such as a button on the page or Click to WhatsApp ads. After the account is connected, it can also be managed from Ads Manager.

Ads Campaign Structure

Each client should attach the Facebook account to the WABA before the partner can work with data from META. See Meta's Official Documentation about Ads Campaign Structure.

Retrieve Client's Facebook Accounts IDs

To retrieve the client_id of clients - check Get List of Clients.

Important! Make sure you use HUB Base URL prefix for Get List of Clients.

Ads & Measurement API don't support /partners endpoint

Retrieve list of attached Facebook accounts of the client

GET https://api.signals.360dialog.io/v1/clients/{client_id}/facebook-accounts

Send a GET request and pick one Facebook account. In case of empty list - ask client to attach Facebook account first.

[
  {
    "id": "2311334042249923",
    "email": "[email protected]"
  }
]

GET https://api.signals.360dialog.io/v1/clients/{client_id}/facebook-accounts/{facebook_account}

Send a GET request and pick the Ad account.

[
  {
    "id": "1011872785512566",
    "name": "Advertiser Company Name"
  }
]

GET https://api.signals.360dialog.io/v1/app/{app_id}/ads/account/{ad_account_id}

Send a GET request and read list of Ads.

To work with pagination concept: offset and limit params are available.

Query Parameters

Name

Type

Description

offset

integer

Starts from 0

limit

integer

From 1 to 100; Default: 20

{
  "data": [
    {
      "id": "23852030589290425",
      "app_id": "93310",
      "name": "CTWA Ad Campaign",
      "status": "ACTIVE",
      "created_time": "2022-11-30T14:05:08+0100",
      "updated_time": "2022-11-30T14:05:08+0100",
      "ad_account": {
        "id": "174816537731874",
        "name": "360dialog.com - Ad-Account",
        "currency": "EUR"
      },
      "campaign": {
        "name": "CTWA campaign",
        "start_time": "2022-11-30T14:05:08+0100"
      },
      "page": {
        "id": "460293477343848",
        "name": "360dialog"
      },
      "insight": {
        "ad_id": "23851172049950328",
        "date": "2023-02-28T08:01:15.667Z",
        "clicks": 541,
        "cpc": 0.8,
        "cpm": 28.04,
        "ctr": 3.5,
        "impressions": 15452,
        "spend": 433.3,
        "sessions": 498,
        "unique_users": 495,
        "keywords_count": 3
      }
    }
  ],
  "total_count": 1,
  "offset": 0,
  "limit": 20
}

schema

PreviousAuth and Base URL NextConfigure Tracking Keywords

Last updated 2 years ago

Was this helpful?

hashtagAds Campaign Structure

hashtagRetrieve Client's Facebook Accounts IDs

hashtagRetrieve list of attached Facebook accounts of the client

hashtagRetrieve list of Ad accounts related to the client's Facebook account

hashtagRetrieve list of Ads related to client's Ad account

hashtagQuery Parameters

Ads Campaign Structure

Retrieve Client's Facebook Accounts IDs

Retrieve list of attached Facebook accounts of the client

Retrieve list of Ad accounts related to the client's Facebook account

Retrieve list of Ads related to client's Ad account

Query Parameters