Contact Form 7对接第三方API：结果验证与动态跳转求助

刚好之前处理过类似的CF7对接第三方API的需求，给你梳理下解决这两个问题的具体步骤：

问题1：验证第三方是否接收信息并生成identifier #

你可以通过三种方式来确认第三方API的处理结果：

1. 开启CF7 to API插件的调试日志 #

这个插件自带日志功能，找到插件设置页面里的「Enable Logging」选项并开启。之后所有API请求的请求体、响应头、响应内容都会被记录在wp-content/uploads/cf7-to-api-logs/目录下的日志文件里。直接打开日志文件，就能看到第三方返回的完整响应，检查是否包含identifier字段。

2. 手动模拟API请求 #

用Postman或者终端的curl命令，把你的JSON模板替换成真实测试数据（比如把[date]换成2024-05-20，[givenName]换成Test），发送请求后查看响应结果。这种方式能快速排除是不是插件配置的问题，确认API本身是否正常返回identifier。

3. 通过WordPress钩子捕获API响应 #

在主题的functions.php里添加代码，利用CF7 to API的qs_cf7_api_after_send钩子，把API响应内容写入WordPress的调试日志或者存到表单提交的自定义字段里：

add_action( 'qs_cf7_api_after_send', 'log_cf7_api_response', 10, 3 );
function log_cf7_api_response( $response, $form_id, $submission ) {
    // 将响应内容写入WP_DEBUG日志
    error_log( 'CF7 API Response Details: ' . print_r( $response, true ) );
    
    // 也可以把响应存到表单提交的自定义字段，方便在后台查看
    if ( isset( $submission->id() ) ) {
        update_post_meta( $submission->id(), '_cf7_api_full_response', wp_remote_retrieve_body( $response ) );
    }
}

开启WP_DEBUG后，就能在wp-content/debug.log里看到完整的API响应，直接检查是否存在identifier。

问题2：表单提交后携带identifier跳转至第三方调研页面 #

这里需要分两种情况处理（CF7默认是AJAX提交，也可以改成普通提交）：

情况A：普通非AJAX提交（关闭CF7的AJAX功能） #

1. 先在CF7表单设置里，把「AJAX提交」选项关掉。
2. 在functions.php里添加代码，先存储identifier，再处理跳转：

// 存储API返回的identifier
add_action( 'qs_cf7_api_after_send', 'store_cf7_identifier', 10, 3 );
function store_cf7_identifier( $response, $form_id, $submission ) {
    // 解析API响应
    $response_data = json_decode( wp_remote_retrieve_body( $response ), true );
    
    // 假设identifier在响应的顶层字段，根据第三方API实际结构调整
    if ( isset( $response_data['identifier'] ) ) {
        // 存到WordPress会话中
        session_start();
        $_SESSION['cf7_redirect_identifier'] = $response_data['identifier'];
    }
}

// 表单提交成功后跳转
add_action( 'wpcf7_mail_sent', 'cf7_redirect_to_survey', 10, 1 );
function cf7_redirect_to_survey( $contact_form ) {
    // 只针对目标表单（替换成你的表单ID）
    if ( $contact_form->id() !== 123 ) return;

    session_start();
    if ( isset( $_SESSION['cf7_redirect_identifier'] ) ) {
        $identifier = $_SESSION['cf7_redirect_identifier'];
        // 清理会话变量，避免重复使用
        unset( $_SESSION['cf7_redirect_identifier'] );
        
        // 跳转至调研页面，携带identifier参数
        $survey_url = 'https://survey.example.com?identifier=' . urlencode( $identifier );
        wp_redirect( $survey_url );
        exit;
    }
}

情况B：AJAX提交（保持CF7默认行为） #

因为AJAX提交后不会刷新页面，需要用JS钩子处理跳转，同时把identifier存在cookie里：

1. 先在functions.php里添加代码存储identifier到cookie：

add_action( 'qs_cf7_api_after_send', 'store_identifier_in_cookie', 10, 3 );
function store_identifier_in_cookie( $response, $form_id, $submission ) {
    $response_data = json_decode( wp_remote_retrieve_body( $response ), true );
    if ( isset( $response_data['identifier'] ) ) {
        // 设置cookie，有效期1小时，按需调整
        setcookie( 
            'cf7_survey_identifier', 
            $response_data['identifier'], 
            time() + 3600, 
            COOKIEPATH, 
            COOKIE_DOMAIN, 
            is_ssl() 
        );
    }
}

2. 再添加JS代码监听CF7提交成功事件，跳转至调研页面：

add_action( 'wp_footer', 'cf7_ajax_redirect_script' );
function cf7_ajax_redirect_script() {
    ?>
    <script>
    // 监听CF7提交成功事件
    document.addEventListener( 'wpcf7mailsent', function( event ) {
        // 获取cookie里的identifier
        const identifier = getCookie('cf7_survey_identifier');
        if (identifier) {
            // 跳转至调研页面，携带参数
            window.location.href = 'https://survey.example.com?identifier=' + encodeURIComponent(identifier);
            // 清理cookie
            document.cookie = "cf7_survey_identifier=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;";
        }
    }, false );

    // 辅助函数：获取指定cookie
    function getCookie(name) {
        const value = `; ${document.cookie}`;
        const parts = value.split(`; ${name}=`);
        if (parts.length === 2) return parts.pop().split(';').shift();
    }
    </script>
    <?php
}

额外注意事项 #

• 要根据第三方API的实际响应结构调整$response_data['identifier']的路径（比如可能是$response_data['data']['identifier']）。
• 可以在钩子里添加响应状态码判断，比如if ( wp_remote_retrieve_response_code($response) === 201 )，确保API请求成功后再处理跳转。

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