Laravel集成Meta Conversation API追踪Purchase Event时遇对象/权限错误

在Laravel搭建的网站上集成Meta Conversation API追踪Purchase Event时，调用自定义setupPurchaseEvent方法返回错误，错误信息如下：

"WWW-Authenticate" => array:1 [▶
0 => "OAuth "Facebook Platform" "invalid_request" "Unsupported post request. Object with ID {$recipientId} does not exist, cannot be
loaded due to missing permissions, or does not support this operation.
Please read the Graph API documentation at
https://developers.facebook.com/docs/graph-api" ◀OAuth "Facebook
Platform" "invalid_request" "Unsupported post request.

对应的实现代码：

public function setupPurchaseEvent($order)
{
    if(!$order)
    {
        return;
    }

    $recipientId = 9999999;

    if (Auth::check()) {
        $recipientId = Auth::user()->id;
    }
    
    $accessToken = env('FACEBOOK_ACCESS_TOKEN');
    $purchaseData = [
        'event' => 'purchase',
        'recipient' => ['id' => $recipientId],
        'purchase' => [
            'purchase_type' => 'onetime',
            'purchase_data' => [
                'currency' => 'EUR',
                'value' => $order->price,
            ],
        ],
    ];

    $response = Http::post("https://graph.facebook.com/v18.0/$recipientId/events?access_token=" . $accessToken, $purchaseData);
    
    return $response;
}

错误原因分析 #

1. Recipient ID 不匹配：代码中使用的$recipientId是Laravel系统内部的用户ID，而Meta Conversation API要求的是Facebook用户PSID（页面范围用户ID），Meta无法识别你系统内部的用户标识，因此提示对象不存在。
2. API端点路径错误：Meta Conversation API的事件上报端点并非/{recipientId}/events，正确的端点需要基于你的Facebook页面ID构建，格式为/{page-id}/events。

解决方案 #

1. 存储用户对应的PSID #

用户与你的Facebook页面互动后会生成唯一的PSID，需要在用户首次授权或互动时，将该PSID与Laravel系统内的用户ID关联并存储到数据库中（例如给User模型新增psid字段）。

2. 修正API请求逻辑 #

修改代码中的端点路径和参数，确保使用正确的页面ID和PSID：

public function setupPurchaseEvent($order)
{
    if(!$order)
    {
        return;
    }

    // 从数据库获取当前用户绑定的PSID
    $psid = Auth::check() ? Auth::user()->psid : null;
    if(!$psid) {
        // 无有效PSID则无法上报事件，直接返回
        return;
    }
    
    $pageId = env('FACEBOOK_PAGE_ID'); // 新增Facebook页面ID配置项
    $accessToken = env('FACEBOOK_ACCESS_TOKEN');
    $purchaseData = [
        'event' => 'purchase',
        'recipient' => ['id' => $psid],
        'purchase' => [
            'purchase_type' => 'onetime',
            'purchase_data' => [
                'currency' => 'EUR',
                'value' => $order->price,
            ],
        ],
    ];

    // 修正为页面ID对应的events端点
    $response = Http::post("https://graph.facebook.com/v18.0/{$pageId}/events?access_token={$accessToken}", $purchaseData);
    
    return $response;
}

3. 验证权限与访问令牌 #

• 确保使用的Facebook AccessToken是页面级令牌，且拥有pages_messaging权限。
• 检查令牌是否过期，可通过Facebook开发者工具验证其有效性。

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