vumi-go 0.5.0

安装

安装依赖项

$ virtualenv --no-site-packages ve
$ source ve/bin/activate
(ve)$ pip install -r requirements.pip

其他所需的东西

• Redis

• RabbitMQ，安装后运行 sudo ./utils/rabbitmq.setup.sh 以设置 vumi RabbitMQ 用户的正确权限。

• Riak，按照以下链接描述进行安装：http://wiki.basho.com/Installation.html

安装 Riak 后，需要编辑 /etc/riak/app.config 文件：将存储后端设置为 eleveldb 而不是 bitcask，并启用 riak_search。

设置开发环境

使用 pip 安装依赖项后，确保 Redis、Riak 和 RabbitMQ 正在运行，然后执行以下命令

(ve)$ ./setup_env.sh

这将生成运行标准应用程序和模拟 USSD 和 SMS 连接的 Telnet 转发的所有必要配置文件。

要开始一些示例会话，例如 Wikipedia，请执行以下命令

(ve)$ ./setup_env/build/go_startup_env.sh

接下来，使用 Supervisord 启动所有内容

(ve)$ supervisord -c setup_env/build/go_supervisord.conf
(ve)$ supervisorctl -c setup_env/build/go_supervisord.conf

现在，您应该可以使用 setup_env/accounts.yaml 中指定的账户详情登录到 Vumi UI，网址为 https://:8000。

默认创建的账户是

默认情况下，Wikipedia USSD 服务配置为在 localhost 8081 上运行。

$ telnet localhost 8081
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Please provide "to_addr":
*120*10001#
Please provide "from_addr":
simon
[Sending all messages to: *120*10001# and from: simon]
What would you like to search Wikipedia for?
...

SMS 交付部分使用“longcode-10001”作为虚拟地址，USSD Wikipedia 中的外发 SMS 会发送到该地址。

使用 GTalk 作为测试的传输方式

为了简化本地开发，我们通常使用 GTalk。您至少需要两个 Gtalk 地址，其中一个将用于 Vumi 传输，另一个您需要与正常的 Gtalk 客户端一起使用以与该服务交互。

使用以下命令启动 XMPP 传输

(ve)$ twistd -n vumi_worker \
>      --worker-class=vumi.transports.xmpp.XMPPTransport
>      --config=path/to/xmpp-config.yaml

XMPP 传输的配置应具有以下参数

transport_name: <desired transport name> # change this
username: <your username> # change this
password: <your password> # change this
host: talk.google.com
port: 5222
status: chat
status_message: Vumi Go!

middleware:
    - logging_mw: vumi.middleware.logging.LoggingMiddleware
    - gtalk_tagging_mw: vumi.middleware.tagger.TaggingMiddleware

logging_mw:
    log_level: debug

gtalk_tagging_mw:
   incoming:
     addr_pattern: '^(.+\@.+)/?.*$'
     tagpool_template: 'xmpp'
     tagname_template: '\1'
   outgoing:
     tagname_pattern: '.*'
     msg_template: {}

为了能够使用此账户进行消息传递，您需要将其添加到 tagpools.yaml 文件中。通过在 pools 下的 ussd_tagpool 下添加以下内容来实现

xmpp_tagpool:
  tags:
    - xmpp@example.org # change this
  metadata:
    display_name: "Google Talk"
    delivery_class: gtalk
    transport_type: xmpp
    user_selects_tag: true
    server_initiated: true
    client_initiated: true
    transport_name: <name of your transport> # change this
    msg_options: {}

接下来，使用此新配置更新 Tagpool Manager

(ve)$ ./go-admin.sh go_setup_env \
        --config-file=./setup_env/config.yaml \
        --tagpool-file=./setup_env/tagpools.yaml

并授予您的账户对新的标签池的访问权限

(ve)$ ./go-admin go_assign_tagpool \
        --email-address=user1@example.org \
        --tagpool=xmpp_tagpool \
        --max-keys=0