curl -X POST "https://api.manychat.com/fb/subscriber/removeTagByName" -H "accept: application/json" -H "Authorization: Bearer 0" -H "Content-Type: application/json" -d "{ "subscriber_id": 0, "tag_name": 0}"

You need to replace the 0’s in the command with the appropriate data: ManyChat API key, subscriber ID, TagName (string). I’ll show you how to use this and what it does below.

Why would you need this?

I’ll quote the exact text from the previous chapter here:

This API is perfect for managing data in your platform or application. For example: you may have tagged your user for a certain interest or follow-up action. Once this action is marked as complete, you can remove the Tag automatically.

Because this method is mostly the same as the Remove Tag by ID, I will not just duplicate the previous chapter and rename ID with Name, but I will make a combination of both methods, in one file.

This is the default response on a successful request, is, as always:

{
  "status": "success"
}

So how do we use this in our own system?

We are going to split this up in 2 parts again:
1. We are going to get all tags by the user ID and display them in a “double” list, so we can …
2. Click a link which will remove the specified Tag from the user, either by ID, or Name, whatever is preferred. We will make 2 different links for this in this file, which could replace the file from the previous chapter.

IF you have the chance to use the TagID, I recommend using that. Although it is more obvious you know the name of a tag by hand, it is also more prone to errors. In general, programming languages don’t like anything other than aZ0-9_ in variable values.

Let’s First add a new function to our class file in classes/manychat.class.php.

    /**
     * 
     * @param type $tag_name
     * @param type $subscriber_id
     * @param type $mc_api
     * @return boolean
     */
    function subscriberRemoveTagByName($tag_name, $subscriber_id, $mc_api)
    {

        $postfields_arr = [
            'subscriber_id' => $subscriber_id,
            'tag_name'      => $tag_name
        ];

        $postfields = json_encode($postfields_arr);

        $ch            = curl_init();
        curl_setopt($ch, CURLOPT_URL, "https://api.manychat.com/fb/subscriber/removeTagByName");
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $postfields . PHP_EOL);
        $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") {
            return true;
        } else {
            return false;
        }
    }

After we created the new function, we will create 2 new PHP files:

1. subscriber_get_tags_by_id_and_name.php
2. subscriber_remove_tag_by_id_or_name.php

The First file is to get a collection for the specific user, we display those for this time in a plain text list, with a hyperlink to delete them. It looks like this:

<?php

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

/*
 * Get the Subscriber Tags by Name AND Id
 */

$subscriber_id   = "1929189923777499";
$subscriber_info = $mc->getSubscriberInfo($subscriber_id, $mc_api);

$subscriber_tags = $subscriber_info->tags;

foreach ($subscriber_tags AS $tag) {
    echo "TAG name and ID" . $tag->name . " (" . $tag->id . ") <a href='./subscriber_remove_tag_by_id_or_name.php?tag_id=" . $tag->id . "&mc_uid=" . $subscriber_id . "'>Remove by ID</a> -- <a href='./subscriber_remove_tag_by_id_or_name.php?tag_name=" . $tag->name . "&mc_uid=" . $subscriber_id . "'>Remove by Name</a><br />"; 
}

It you run this script in your browser, you’ll see something similar to this:

It doesn’t look nice, but if you put this little snippet of code inside a basic Bootstrap theme, it will immediately look great. Just wrap the hyperlinks in HTML Buttons instead of textlinks and add a little padding between the paragraph lines and voilá!

Now let’s create the PHP file for the links, so we can remove and cleanup the Tag. The second PHP file will look like this, note that I created a simple if<>else clause here to check what variable is sent through the link. Since the Id is most accurate, we look fo rthat First, if it is not there, we move on to the next clause and we finish with an exit routine if nothing is found:

<?php

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

/*
 * Remove Subscriber TAG by Id or Name
 */

$clean_data          = filter_input_array(INPUT_GET, FILTER_SANITIZE_STRING);
$subscriber_tag_id   = $clean_data['tag_id'] ?? "";
$subscriber_tag_name = $clean_data['tag_name'] ?? "";
$mc_uid              = $clean_data['mc_uid'];

if (!empty($subscriber_tag_id)) {
    $subscriber_remove_tag = $mc->subscriberRemoveTag($subscriber_tag_id, $mc_uid, $mc_api);
    $subscriber_tag        = $subscriber_tag_id;
} elseif (!empty($subscriber_tag_name)) {
    $subscriber_remove_tag = $mc->subscriberRemoveTagByName($subscriber_tag_name, $mc_uid, $mc_api);
    $subscriber_tag        = $subscriber_tag_name;
} else {
    exit("No Tags set to remove");
}

if ($subscriber_remove_tag) {
    echo "Bingo! You removed the following Tag : " . $subscriber_tag . " from subscriber number " . $mc_uid;
} else {
    echo "We could not remove your Tag";
}

$subscriber_remove_tag will return TRUE for a correct response, which will allow us to report back the result.

So, when we click the Remove by Name link for TAG Name and ID Language Preference is English (16205530) from the Tag list above, we get this result:

Pretty handy, right?

Next, we are going to set Custom fields, a very common and much used API.