ServiceM8 api电子邮件 - 如何与工作日记相关联

时间:2016-10-14 13:25:30

标签: email-integration

我可以通过ServiceM8 API'消息服务从ServiceM8帐户发送电子邮件。 (http://developer.servicem8.com/docs/platform-services/message-services/),并阅读生成的ServiceM8消息ID。

但我想将该消息与ServiceM8中的特定作业相关联,以便它在ServiceM8 Web应用程序的该作业日记中显示为电子邮件项目。 (从ServiceM8 Web应用程序中发送的电子邮件与日记相关并出现在那里 - 我的问题是如何从API执行此操作。)

最糟糕的情况是,我可以创建一个新的“注意事项”。包含电子邮件文本并将其添加到作业中,希望它将作为注释显示在Web应用程序的日记中。

但我想检查一下,由于发送电子邮件结果已经在ServiceM8中已经存在可关联的消息ID,因此没有更简单的方法。

由于

1 个答案:

答案 0 :(得分:0)

使用消息传递服务API无法完成。使用Web API,您就可以做到这一点。

需要一个特定于您的帐户和此功能的授权代码,您只需要检索一次,然后您就可以将该特定网址集成到您的代码中。它包含在ClientSidePlatform_PerSessionSetup URL中。

这是一个脚本,它将获取特定于您登录的电子邮件URL:

语法: #!/usr/bin/env bash #getsm8emailurl.sh #Create Basic auth user="$1" pass="$2" pass="$(echo -n "${pass}" | md5sum | cut -f1 -d' ')" auth="$(echo -n "${user}:${pass}" | base64)" #Get Account specific e-mail url email_url="https://go.servicem8.com/$(curl --compressed -s -L "https://go.servicem8.com/$(curl --compressed -s -L "https://go.servicem8.com/" -H "Authorization: Basic $auth" | grep -o 'ClientSidePlatform_PerSessionSetup.[^"]*' | grep -v "s_boolFailover")" -H "Authorization: Basic $auth" | grep -o "PluginEmailClient_SendEmail.[^']*")" #Output base e-mail URL echo "$email_url"

https://go.servicem8.com/PluginEmailClient_SendEmail

获得电子邮件网址后(将以"guid-to-cc-subject-msg-job_id-attachedFiles-attachedContacts-strRegardingObjectUUID-strRegardingObject-boolAllowDirectReply"开头并以s_auth代码结尾),您可以像使用其他任何其他端点一样使用它。

必填标题值:

  • 授权(与常规API相同)

必修邮件参数:

  • s_form_values = #!/usr/bin/env bash #sendemail.sh #demo here using random auth codes and uuids curl --compressed -s "https://go.servicem8.com/PluginEmailClient_SendEmail" \ -H "Authorization: Basic dGVzdHVzZXJAdGVzdGRvbWFpbi5jb206dGVzdHBhc3M=" \ -d s_form_values=guid-to-cc-subject-msg-job_id-attachedFiles-attachedContacts-strRegardingObjectUUID-strRegardingObject-boolAllowDirectReply \ -d s_auth="6akj209db12bikbs01hbobi3r0fws7j2" \ -d boolAllowDirectReply=true \ -d strRegardingObject=job \ -d strRegardingObjectUUID="512b3b2a-007e-431b-be23-4bd812f2aeaf" \ -d to="test@testdomain.com" \ -d subject="Job Diary E-mail" \ -d msg="hello" (这些必须保持原样)
  • <强> s_auth = “your_account_s_auth_code”

  • = “recipient@domain.com”

可选帖子参数:

  • <强>受试者 = “受试者”

  • msg =“html邮件正文”

  • boolAllowDirectReply =“true | false”(收件人可以直接回复工作日记)

  • <强> strRegardingObject = “作业|公司”

  • strRegardingObjectUUID =“job | company uuid”

样本

./myprogram | tee output.txt

编辑/更新/声明: 这些信息是为了方便和高效 - 备忘录,快速任务,通知,更新等。对于关键业务操作而言,这不是可靠的,因为它没有文档记录,并且由于它不像浏览器那样处理JS,它可以如果服务的内部工作发生变化,则停止工作。