如何无需插件/第三方工具通过API将JIRA评论推送至Salesforce？

这个需求完全可行，不需要依赖任何第三方插件或工具，核心是通过对接JIRA和Salesforce的原生API，搭建一个轻量的中间服务来完成数据流转。以下是具体实现思路和极简案例：

核心实现步骤 #

• 监听JIRA评论事件：
  • 优先用JIRA的Webhook功能，配置当工单有新评论/评论更新时，自动触发请求到你的中间服务（JIRA后台→系统→Webhooks）
  • 若无法配置Webhook，可通过轮询JIRA的/rest/api/3/issue/{issueIdOrKey}/comment API，定期拉取新增评论
• 处理评论数据：
  • 在中间服务里解析JIRA返回的JSON数据，提取评论内容、创建人、关联工单ID、创建时间等核心字段
• 推送至Salesforce：
  • 调用Salesforce的REST API（比如/services/data/vXX.X/sobjects/CaseComment或自定义对象），将处理后的评论写入对应记录
  • 提前在Salesforce中配置API权限，通过OAuth 2.0获取合法的访问令牌

极简Python实现案例 #

1. JIRA Webhook接收服务（基于Flask） #

from flask import Flask, request
import requests
import json

app = Flask(__name__)

# 替换为你的Salesforce配置
SF_BASE_URL = "https://your-sf-domain.my.salesforce.com"
SF_ACCESS_TOKEN = "your-oauth-token"
SF_TARGET_OBJECT = "CaseComment"  # 若用自定义对象，替换为你的对象API名，比如JIRA_Comment__c

# 假设你已经维护了JIRA工单Key到Salesforce Case ID的映射
JIRA_TO_SF_CASE_MAP = {
    "PROJ-123": "500D0000001abcDEF",
    # 更多映射...
}

@app.route('/jira-comment-webhook', methods=['POST'])
def handle_jira_comment():
    # 解析JIRA Webhook推送的事件
    jira_event = request.json
    comment_info = jira_event.get('comment', {})
    issue_key = jira_event.get('issue', {}).get('key')
    
    # 跳过空评论或无映射的工单
    if not comment_info.get('body') or issue_key not in JIRA_TO_SF_CASE_MAP:
        return "跳过无效数据", 200
    
    # 构造Salesforce需要的评论数据
    sf_comment_data = {
        "ParentId": JIRA_TO_SF_CASE_MAP[issue_key],
        "CommentBody": comment_info.get('body'),
        "JIRA_Issue_Key__c": issue_key  # 自定义字段，用于关联JIRA工单
    }
    
    # 调用Salesforce API推送
    sf_api_url = f"{SF_BASE_URL}/services/data/v59.0/sobjects/{SF_TARGET_OBJECT}"
    headers = {
        "Authorization": f"Bearer {SF_ACCESS_TOKEN}",
        "Content-Type": "application/json"
    }
    
    response = requests.post(sf_api_url, headers=headers, data=json.dumps(sf_comment_data))
    if response.status_code == 201:
        return "评论推送成功", 200
    else:
        # 这里可以添加日志记录或重试逻辑
        return f"推送失败: {response.text}", 500

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

2. 关键注意点 #

• 记录关联：必须提前维护JIRA工单与Salesforce对应记录的映射关系，可通过在Salesforce记录中存储JIRA Key，或在中间服务里维护映射表
• 认证安全：
  • JIRA Webhook建议开启签名验证，防止非法请求
  • Salesforce用OAuth 2.0的刷新令牌机制，自动更新访问令牌，避免手动维护
• 异常处理：添加重试机制、日志记录，处理API调用失败、网络超时等情况
• 历史数据同步：如果需要同步已有评论，直接调用JIRA的评论API批量拉取，再批量推送到Salesforce

内容的提问来源于stack exchange，提问作者Marck