跳转至

Twilio

你可以使用 Twilio 连接器部署可通过短信获取消息的对话机器人。

获取凭据

你必须首先创建一个 Twilio 应用来获取凭据。之后可以将它们添加到 credentials.yml 中。

如何获取 Twilio 凭据,你需要设置 Twilio 机器人。

  1. 创建 Twilio 账户后,你需要创建一个新项目。这里要选择的最重要的产品是 Programmable SMS
  2. 创建项目后,导航到 Programmable SMS 的仪表盘,然后单击 Get Started。按照步骤将电话号码连接到项目。
  3. 现在可以在 credentials.yml 中使用 Account SIDAuth Token 和购买的电话号码了。
  4. 导航到 Twilio 仪表盘中的 Phone Numbers 并选择你的电话号码来配置 webhook URL。找到 Messaging 部分并将你的 webhook URL(例如:https://<host>:<port>/webhooks/twilio/webhook,将主机和端口替换为你正在运行的 Rasa 服务器的适当值)添加到 A MESSAGE COMES IN 设置中。

更多信息请参见 Twilio REST API

连接到 WhatsApp

你可以通过 Twilio 将 Rasa 对话机器人部署到 WhatsApp。为此,你必须拥有 WhatsApp Business 资料。将 WhatsApp Business 资料与你通过 Twilio 购买的电话号码相关联,从而访问适用于 WhatsApp 的 Twilio API

根据 Twilio API 文档,你使用的电话号码应以 whatsapp: 为前缀,如下面 credentials.yml 中的描述。

在 Twilio 上运行

将 Twilio 凭据添加到 credentials.yml 中:

twilio:
  account_sid: "ACbc2dxxxxxxxxxxxx19d54bdcd6e41186"
  auth_token: "e231c197493a7122d475b4xxxxxxxxxx"
  twilio_number: "+440123456789"  # if using WhatsApp: "whatsapp:+440123456789"

重启你的 Rasa 服务器,使新的频道端点可供 Twilio 发送消息。

使用 Twilio 从 Whatsapp 接受位置数据

你可以通过如下方式从该频道上的用户接收位置数据(WhatsApp 位置):

  1. 创建一个名为 locationData 的意图,并分别为纬度和经度定义两个实体和槽。

    domain.yml
    intents:
      - locationData
    
    slots:
      Latitude:
        type: text
        mappings:
        - type: from_entity
          entity: Latitude
    
      Longitude:
        type: text
        mappings:
        - type: from_entity
          entity: Longitude
    
    entities:
      - Latitude
      - Longitude
    
  2. 当用户发送位置消息时,将触发 `locationData`` 意图并从实体设置槽值。请注意,不需要为实体提供训练数据,因为它们由频道处理。