Dialogflow V2交易功能无响应，求V2版本交易示例代码

Got it, let's work through this Dialogflow V2 Transactions issue you're hitting. It’s super common to run into snags when moving from V1 to V2 because the API structure for transactions changed pretty significantly. The official V1 examples don’t map directly over, so let’s break down a working V2 implementation with code samples that should get you past the no-response problem.

Before diving into code, here are the critical changes that often cause silent failures:

• Client Library: V2 uses the official @google-cloud/dialogflow (Node.js) or google-cloud-dialogflow (Python) packages instead of the old apiai library.
• Payload Structure: Transaction data lives under the google field in fulfillment responses, not in V1-style contexts.
• Authentication: Server-side calls require a service account JSON key, not client access tokens.
• System Intents: You must leverage Google Actions system intents (like actions.intent.TRANSACTION_REQUIREMENTS_CHECK) to trigger transaction flows.

First, install the required client library:

npm install @google-cloud/dialogflow

1. Initialize the Dialogflow Client #

const dialogflow = require('@google-cloud/dialogflow');
const sessionClient = new dialogflow.SessionsClient({
  keyFilename: '/path/to/your/service-account-key.json' // Replace with your key path
});

2. Webhook Response to Initiate Transaction #

When your user triggers a purchase intent (e.g., "I want to buy this"), send this response to start the transaction flow:

// Example Express.js webhook endpoint
app.post('/dialogflow-webhook', async (req, res) => {
  const intentName = req.body.queryResult.intent.displayName;

  if (intentName === 'ConfirmPurchaseIntent') {
    // Build the transaction initiation payload
    const transactionPayload = {
      google: {
        expectUserResponse: true,
        richResponse: {
          items: [
            {
              simpleResponse: {
                textToSpeech: "Great! Let's process your order. I need to confirm your shipping address first."
              }
            }
          ]
        },
        systemIntent: {
          intent: "actions.intent.TRANSACTION_REQUIREMENTS_CHECK",
          data: {
            "@type": "type.googleapis.com/google.actions.v2.TransactionRequirementsCheckSpec",
            paymentOptions: {
              actionProvidedOptions: {
                displayName: "Credit/Debit Card",
                paymentType: "PAYMENT_TYPE_CARD"
              }
            }
          }
        }
      }
    };

    // Send response back to Dialogflow
    res.json({
      fulfillmentMessages: [
        { payload: transactionPayload }
      ]
    });
  } else {
    res.json({ fulfillmentText: "Sorry, I didn't catch that. Can you repeat?" });
  }
});

3. Handle Transaction Status Follow-Up #

After the user completes the transaction check (address/payment confirmation), Dialogflow will send a follow-up request. Here’s how to process it:

// Add this logic to your webhook endpoint
if (req.body.queryResult.webhookPayload?.google?.transactionStatus) {
  const transactionStatus = req.body.queryResult.webhookPayload.google.transactionStatus;

  if (transactionStatus.state === "TRANSACTION_STATE_OK") {
    // Transaction passed—process the order
    const successPayload = {
      google: {
        expectUserResponse: false,
        richResponse: {
          items: [
            {
              simpleResponse: {
                textToSpeech: "Your order is confirmed! We'll send you a tracking number shortly. Thanks for shopping with us!"
              }
            }
          ]
        }
      }
    };

    res.json({ fulfillmentMessages: [{ payload: successPayload }] });
  } else {
    // Transaction failed—handle error
    res.json({ fulfillmentText: "Oops, something went wrong with your transaction. Let's try again later or use a different payment method." });
  }
}

If you’re working with Python, here’s a Flask-based implementation:

from flask import Flask, jsonify, request

app = Flask(__name__)

@app.route('/dialogflow-webhook', methods=['POST'])
def webhook():
    req_data = request.get_json()
    intent_name = req_data['queryResult']['intent']['displayName']

    if intent_name == 'ConfirmPurchaseIntent':
        transaction_payload = {
            "google": {
                "expectUserResponse": True,
                "richResponse": {
                    "items": [
                        {
                            "simpleResponse": {
                                "textToSpeech": "Let's finalize your order. I'll need to verify your payment details."
                            }
                        }
                    ]
                },
                "systemIntent": {
                    "intent": "actions.intent.TRANSACTION_REQUIREMENTS_CHECK",
                    "data": {
                        "@type": "type.googleapis.com/google.actions.v2.TransactionRequirementsCheckSpec",
                        "paymentOptions": {
                            "actionProvidedOptions": {
                                "displayName": "Credit Card",
                                "paymentType": "PAYMENT_TYPE_CARD"
                            }
                        }
                    }
                }
            }
        }
        return jsonify({
            "fulfillmentMessages": [
                {"payload": transaction_payload}
            ]
        })

    # Handle transaction status follow-up
    if 'webhookPayload' in req_data['queryResult'] and 'google' in req_data['queryResult']['webhookPayload']:
        transaction_status = req_data['queryResult']['webhookPayload']['google'].get('transactionStatus')
        if transaction_status and transaction_status['state'] == "TRANSACTION_STATE_OK":
            return jsonify({
                "fulfillmentMessages": [
                    {
                        "payload": {
                            "google": {
                                "expectUserResponse": False,
                                "richResponse": {
                                    "items": [{"simpleResponse": {"textToSpeech": "Order processed successfully! Thank you."}}]
                                }
                            }
                        }
                    }
                ]
            })
        else:
            return jsonify({"fulfillmentText": "Transaction failed. Please try again."})

    return jsonify({"fulfillmentText": "I didn't understand that. Can you rephrase?"})

if __name__ == '__main__':
    app.run(port=5000, debug=True)

Quick Troubleshooting Tips #

• Double-check that your service account has the Dialogflow API Client role assigned in Google Cloud Console.
• Ensure your webhook is publicly accessible (use tools like ngrok for local testing).
• Verify that the systemIntent name matches exactly (case-sensitive: actions.intent.TRANSACTION_REQUIREMENTS_CHECK).

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