Manychat进阶应用：生成动态内容


做跨境的应该都已经对Messanger Marketing都很了解了，随着Amazon对review的把控越来越严格，找review的难度也越来越大，这要求我们尽可能找到相应市场里购买记录良好的真实用户为我们留评。那么到哪里去找真实用户呢，SNS平台因为其高参与性自然就进入我们的视野，而其中Facebook也因为其用户量巨大且真实，成为我们SNS推广的首选。目前，SNS平台的流量引入Chatbot(Manychat、Chatbot或自己设计bot)引导用户留评的方式仍然是最高效且附加值比较高的。

而Chatbot在这里扮演着非常重要的角色。它们是流量的承接平台，也是我们引导用户留评最前线的通道。因此一个设计良好的chatbot不仅能极大的提高我们的效率，而且还能提高转化率并降低我们的广告费用。因为个人使用Manychat比较多，所以最近也会以Manychat为例来聊下chatbot在跨境电商里的作用。

这篇文章是Manychat系列之一，其他也会陆续更新。今天我们就来说下Manychat的Dynamic Block的基础知识吧，后面会在另一篇文章聊下应用。

动态内容（Dynamic Block）可以让我们接收服务器生成的message，并将其发送给我们的Subscribers。要想生成对应形式的message，我们需要让服务器根据Manychat的要求生成特定格式的数据，Manychat支持的message形式在这个文档里有详细说明。（此文后面也会说到）

首选，我们来看下如何创建动态内容~

创建动态内容

在创建flow时会发现Pro账户的下面有一个发送Dynamic的选项，这里就是我们创建动态内容的地方，如图：


选择了“Dynamic”之后，点击我们的动态内容，会弹出设置的对话框，如图：


好了，我们就在这里开始创建动态内容：

  1. 选择HTTP请求方法（GET或POST）
  2. 在Request URL那里输入生成数据的URL。如果我们现在还没有自己的服务器应用来生成数据，我们可以用Glitch提供的服务来做练习。这里也是用Glitch的应用来做测试（具体方法下一小节会介绍）
  3. 根据自己的需求填入请求的'Headers'和'Body'

  4. 都填写完后点'Test the Request'来测试下是否能返回自己想要的数据。返回200则代表访问成功。


  5. 都设置好之后就可以了，但最好再给动态内容添加一个Fallback步骤，Fallback会在动态内容出错的时候被调用。就是这里：


用Glicth应用练习

如果没有用来练习Dev Tools的服务器，我们可以用Glitch来做练习。Manychat官方在Glitch提供了供我们练习的start项目，我们直接去remix这个项目就可以了。

在Glitch上创建项目

  1. 首先我们打开manychat在Glitch提供的starter webhook项目，进去后点右上角的'Remix Your Own'按钮复制一份。


  2. 在左上角，点击'Show'，在下拉菜单选择在新窗口打开，并复制公共项目的URL。这就是我们用来生成数据的URL。


  3. 有了地址后，和上文一样，我们在创建一个动态内容的message。在‘Request URL’添加我们刚刚复制的服务器地址：


  4. 好了！现在我们点'Test the Request'来测试下，如果返回了'Hello from server!'，则说明我们成功从Glitch获取到了数据。

  5. 接下来我们就可以在Glitch里编写想要返回给动态内容的数据了。注意：服务器返回数据必须遵循Manychat的格式，这样才能生成正确样式的message。具体可以参考下文或Manychat的官方文档: Dynamic Block

好了，到这里我们已经可以动态生成内容了，如果chatbot的flow不是特别复杂，我们可以先将服务部署在glitch或heroku上，等后期项目复杂之后再迁到自己的服务器上。剩下的只需要熟悉Manychat为我们提供的内容格式了，Manychat官方文档在这里，这篇文章也会不断更新。

dynamic_block文档

Maynchat Dynamic Block原文档地址

响应的格式

服务器返回的json数据应该如下列格式：

{
  "version": "v2", //dynamic_block的版本
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text"
      },
      {
        ...Another messages
      }
    ],
    "actions": [  //optional
      {
        "action": "add_tag",
        "tag_name": "example tag"
      },
      {
        ...Another actions
      }
    ],
    "quick_replies": [ //optional
      {
        "type": "node",
        "caption": "Quick reply text",
        "target": "My Content"
      },
      {
        ...Another quick replies
      }
    ]
  }
}

PS: 动态内容API v2目前只支持不超过10条的messages，11条快捷回复和5个actions。其中“buttons”，“actions”和“quick_replies”属性是可选的。

Messages类型

文字

用来发送text信息，支持和url、flow、node、call buttons一起使用。"buttons", "actions", "quick_replies"属性可省略。

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "url",
            "caption": "External link",
            "url": "https://manychat.com"
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

图片、音频、视频

用来发送图片、音频、视频，支持JPG、PNG和GIF图片格式和25mb以内的音、视频文件，可以与url、call, buy、flow、node、share buttons一起使用。"buttons", "actions", "quick_replies"属性可省略。

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "image",
        //"type": "video", 
        // "type": "audio",
        "url": "文件url地址",
        "buttons": []
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

文件

用来传送文件，支持25mb以内的文件，"actions", "quick_replies"属性是可选择的。

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "file",
        "url": "https://manybot-thumbnails.s3.eu-central-1.amazonaws.com/ca/xxxxxxzzzzzzzzz.pdf"
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

卡片Gallery(常用)

用来发送可水平滚动的卡片gallery，可以与url、call、buy、flow、node和share buttons一起使用。"action_url", "buttons", "actions", "quick_replies"属性可省略。

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "cards",
        "elements": [
          {
            "title": "Card title",
            "subtitle": "card text",
            "image_url": "https://manybot-thumbnails.s3.eu-central-1.amazonaws.com/ca/xxxxxxzzzzzzzzz.png",
            "action_url": "https://manychat.com",
            "buttons": []
          }
        ],
        "image_aspect_ratio": "horizontal"
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

action_url - 建议使用HTTPS的URL，HTTP地址在某些浏览器可能打不开。
image_aspect_ratio - 设置图片显示的纵横比。可以使用horizontal(默认)或者square(1:1)。

列表(常用)

用来发送列表，可以与url、flow、node和buy buttons一起使用，'top_element_style', 'action_url', 'buttons', 'actions', 'quick_replies'属性可省略。

列表有两种展示方式：

  1. 'top_element_style': 'large', 第一个列表元素以封面大图加文字的方式展示。
  2. 'top_element_style': 'compact'，无突出展示，所有列表元素形式相同（普通列表）。

列表可容纳元素数量在2~4个。

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "list",
        "top_element_style": "compact",
        "buttons": [],
        "elements": [
          {
            "title": "list title1",
            "subtitle": "list substitle2",
            "image_url": "https://manybot-thumbnails.s3.eu-central-1.amazonaws.com/ca/xxxxxxzzzzzzzzz.png"
            "action_url": "https://manychat.com",
            "buttons": []
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

按钮(常用)

按钮分为call、url、share、flow、node和buy这几种类型，其中actions属性指定按钮触发时进行的actions，可以是url、flow或node button类型。actions属性可省略。
按钮基本格式：

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text",
        "buttons": [
          {
            "type": "url",
            "caption": "External link",
            "url": "https://manychat.com",
            "actions": [] //optional
          },
          {
            ...Another buttons
          }
        ]
      },
      {
        ...Another messages
      }
    ],
    "actions": [  //optional
      {
        "action": "add_tag",
        "tag_name": "example tag"
      },
      {
        ...Another actions
      }
    ],
    "quick_replies": [ //optional
      {
        "type": "node",
        "caption": "Quick reply text",
        "target": "My Content"
      },
      {
        ...Another quick replies
      }
    ]
  }
}

电话按钮

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "call",
            "caption": "Call me",
            "phone": "+1 (555) 555-55-55"
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

URL按钮

URL按钮的webview_size属性有3种：（该属性定义在Manychat里打开url时窗口的大小，可省略）

  • full - (100%)
  • medium - (75%)
  • compact - (50%)
{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "url",
            "caption": "External link",
            "url": "https://manychat.com",
            "webview_size": "full"
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

分享按钮

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "share"
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

节点按钮*

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "node",
            "caption": "Show",
            "target": "My Content"
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

target 的值是节点名，其指定的节点必须存在于正在执行的flow。节点名可以在node的header里看到。连接到的节点的名字在该flow中必须是唯一的。跳转按钮仅支持flow内部访问，不支持Public API访问。
节点名在这里~

flow跳转按钮

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "flow",
            "caption": "Go",
            "target": "content20180221085508_278589"
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

target 字段需要指定flow ID，flow ID可以在flow被打开时找到。如下图：

购买按钮

购买按钮只有在Stripe已经配置好的情况下使用。 "success_target" 属性可省略。

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type":    "buy",
            "caption": "Buy",
            "customer": {
              "shipping_address": true,
              "contact_name":     false,
              "contact_phone":    true
            },
            "product": {
              "label": "T-shirt",
              "cost": 2250
            },
            "success_target": "My Content"
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

shipping_address, contact_name, contact_phone 字段是必须的，要用来设置付款表单；
product.cost 应该按照美分来计数（比如$22.5需要指定的值是2250）
success_target 字段需要连接到执行中flow的某个节点，节点名可以在节点的头部找到，连接到的节点的名字在该flow中必须是唯一的。

Dynamic block callback按钮

'headers', 'payload'属性可省略。

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "dynamic_block_callback",
            "caption": "Dynamic content",
            "url": "https://your-service.com/dynamic",
            "method": "post",
            "headers": {
              "x-header": "value"
            },
            "payload": {
              "key": "value"
            }
          }
        ]
      }
    ],
    "actions": [],
    "quick_replies": []
  }
}

该按钮的工作方式和动态内容一样，都会向服务器请求内容，并生成Manychat相应格式的内容。

Actions类型

actions属性是在所有类型的数据中都是可选的。

添加/删除标签

为subscriber添加/删除标签，标签必须存在。

{
  "version": "v2",
  "content": {
    "messages": [{}],
    "actions": [
    //添加标签
      {
        "action": "add_tag",
        "tag_name": "your tag",
      },
     //删除标签
      {
        "action": "remove_tag",
        "tag_name": "your tag",
       }
    ],
    "quick_replies": []
  }
}

添加/清除custom field

为用户添加/清除custom field，custom field必须存在。
PS：添加custom field时要注意其数据类型，必须符合原来定义的数据类型。

{
  "version": "v2",
  "content": {
    "messages": [{}],
    "actions": [
    // 添加custom field
      {
        "action": "set_field_value",
        "field_name": "your field name",
        "value": "some value"
      },
      // 删除custom field
      {
        "action": "unset_field_value",
        "field_name": "your field name",
        "value": "some value"
      }
    ],
    "quick_replies": []
  }
}

custom field支持的数据类型

  • Number ：2 or 3.14
  • Text："文字"
  • Date：采用YYYY-MM-DD格式，类似"2018-03-25"
  • Date Time：采用ISO8601 UTC格式，类似"2018-03-25T13:25:00.000Z"
  • True/False：true或false

快捷回复

quick_replies 是可选的。 如果动态内容里内容块之后还有其他内容，则不能使用快捷回复。快捷回复的设置和按钮相同，支持content, node, dynamic_block_callback 3种类型。

跳转到某节点

{
  "version": "v2",
  "content": {
    "messages": [{}],
    "actions": [],
    // 此处定义快捷回复
    "quick_replies": [
      {
        "type": "node",
        "caption": "Show",
        "target": "My Content"
      }
    ]
  }
}

此处对节点的要求和go to node按钮的要求相同。

跳转到flow

{
  "version": "v2",
  "content": {
    "messages": [{}],
    "actions": [],
    "quick_replies": [
      {
        "type": "flow",
        "caption": "Go",
        "target": "content20180221085508_278589"
      }
    ]
  }
}

动态内容快捷回复

headers和payload属性是可选的。

{
  "version": "v2",
  "content": {
    "messages": [{}],
    "actions": [],
    "quick_replies": [
      {
        "type": "dynamic_block_callback",
        "caption": "Dynamic content",
        "url": "https://your-service.com/dynamic",
        "method": "post",
        "headers": {
          "x-header": "value"
        },
        "payload": {
          "key": "value"
      }
    ]
  }
}

External Message Callback

external_message_callback 属性是可选的，该属性可以将用户输入的数据传给特定的服务器处理。
payload里的{{last_input_text}} 变量保存着用户的message信息。该信息默认且最多保存一天，可以在payload里用timeouit属性来指定保存的时间。

{
  "version": "v2",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "Hello! How are you?"
      }
    ],
    "actions": [],
    "quick_replies": [],
    "external_message_callback": {
        "url": "https://your-service.com/dynamic",
        "method": "post",
        "headers": {
          "x-header": "value"
        },
        "payload": {
          "id": "{{user_id}}",
          "last_input_text": "{{last_input_text}}",
          "key": "value"
        },
        "timeout": 600
    }
  }
}

external_message_callback 和动态内容工作方式相同。

变量

在动态内容的请求体里(Request)，可以使用Full Subscriber Data变量，该变量包含了subscriber的所有信息。

{
    "id": 13245647xxxxxxxxx,
    "key": "user:13245647xxxxxxxxx",
    "page_id": 234564657xxxxxxxx,
    "status": "active",
    "first_name": "Subscriber",
    "last_name": "Lastname",
    "name": "Subscriber Lastname",
    "gender": "male",
    "profile_pic": "https://xxxxxxxxx.com/subscribers/big_xxxxxxxxxxxxxxxx.jpg",
    "locale": "en_US",
    "language": "English",
    "timezone": "UTC-07",
    "live_chat_url": "https://manychat.com/fb234564657xxxxxxxx/chat/13245647xxxxxxxxx",
    "last_input_text": "Last subscriber's input text",
    "last_growth_tool": null,
    "subscribed": "2018-07-02T00:00:00+00:00",
    "last_interaction": "2018-07-02T00:00:00+00:00",
    "last_seen": "2018-07-02T00:00:00+00:00",
    "custom_fields": {
        "customField": 0.75,
        "customDate": "2018-05-31",
        "customBool": true,
        ...
    }

}
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 216,544评论 6赞 501
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 92,430评论 3赞 392
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 162,764评论 0赞 353
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 58,193评论 1赞 292
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 67,216评论 6赞 388
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 51,182评论 1赞 299
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 40,063评论 3赞 418
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,917评论 0赞 274
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 45,329评论 1赞 310
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,543评论 2赞 332
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,722评论 1赞 348
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,425评论 5赞 343
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 41,019评论 3赞 326
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,671评论 0赞 22
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,825评论 1赞 269
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,729评论 2赞 368
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,614评论 2赞 353