curl -X GET "https://api.manychat.com/fb/page/getTags" -H "accept: application/json"

The purpose of this API call is to GET all TAGS currently in your ManyChat account.

Why would you need this?

A use case could be: if you have a platform where people can be tagged, you can use this list of available TAGS as a reference in a webform select menu.

This is the default response on a successful request

{
  "status": "success",
  "data": [
    {
      "id": 0,
      "name": "string1"
    },
    {
      "id": 1,
      "name": "string2"
    }
  ]
}

So how do we use this in our own system?

We assume you started in the First chapter of this course, and are now aware of the creation of the class file and the config file.
Those files are being used in ALL scripts we explain in the course. If you missed it, go here and read it.

First we will add a new function to our class file in classes/manychat.class.php.

    /**
     * 
     * @param type $mc_api
     * @return type
     */
    function getPageTags($mc_api)
    {

        $ch            = curl_init();
        curl_setopt($ch, CURLOPT_URL, "https://api.manychat.com/fb/page/getTags");
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        $headers       = [
            'Authorization: Bearer ' . preg_replace("/^(\w+\s+)/", "", $mc_api),
            'Content-Type: application/json',
            'Accept: application/json'
        ];
        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        $server_output = curl_exec($ch);
        curl_close($ch);

        $json_obj  = json_decode($server_output);
        $good_call = $json_obj->status;

        if ($good_call == "success") {
            usort($json_obj->data, function($a, $b) {
                return strcmp($a->name, $b->name);
            });
            $tags = [];
            foreach ($json_obj->data as $mc_page_tags) {
                $tags[$mc_page_tags->name] = $mc_page_tags->name;
            }
            return $tags;
        }
    } 

After we created the new function, we will create a new PHP file and call it page_get_tags.php. Here’s the start of our new PHP file:

<?php

/*
 * Load the ManyChat Config File
 */
require_once './config.inc.php';

/*
 * Get the TAGS for your page
 */

// add functions here

We will add a call to the function from the class file now, and display all TAGS in alphabetical (we used an anonymous function to sort the keys by name) order. We will do that as follows.

First, we add this line:

$page_tags = $mc->getPageTags($mc_api);

foreach($page_tags AS $tag){
    echo $tag . "<br />";
}

Now, when we run the file (page_get_tags.php) in our browser, we should see the result as a long list of your page tags:

That’s great! We successfully retrieved all TAGS in the ManyChat system, all in our own environment!

We used the foreach loop to iterate through the Array that was created in our class function. If you need more information about how foreach functions work, please check this link on php.net:

• foreach – https://www.php.net/manual/en/control-structures.foreach.php

We now have a fully functional script that gets all your TAGs, all from our own localhost, or server. That was cool, right?

The full PHP script now looks like this:

<?php

/*
 * Load the ManyChat Config File
 */
require_once './config.inc.php';

/*
 * Get the TAGS for your page
 */

$page_tags = $mc->getPageTags($mc_api);

foreach($page_tags AS $tag){
    echo $tag . "<br />";
}