จัดการตัวแทนด้วย RBM Operations API

ขั้นตอนการทำงานหลักของ RBM สำหรับผู้ให้บริการรวมถึงการตรวจสอบข้อมูลเกี่ยวกับ ตัวแทนใหม่ๆ และการอนุมัติหรือปฏิเสธสิทธิ์ในการเปิดใช้บนเครือข่ายของผู้ให้บริการ และส่งข้อความถึงสมาชิกของตน

ข้อมูลโค้ดในหน้านี้มาจากตัวอย่าง JavaScript และ Curl

แสดงรายการตัวแทนทั้งหมดที่ส่งไปยังผู้ให้บริการ

ผู้ให้บริการจะรับรายการ Agent ทั้งหมดที่นักพัฒนาซอฟต์แวร์ส่งสำหรับการเปิดตัวในเครือข่ายของผู้ให้บริการได้

Node.js

const businessCommunicationsApiHelper =
  require('@google/rbm-businesscommunications');

const privateKey =
  require('../../resources/businesscommunications-service-account-credentials.json');

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

// Retrieve all agents targeting the carrier
businessCommunicationsApiHelper.listAgents('brands/-').then((response) => {
  console.log('Current agents are:');
  console.log(JSON.stringify(response.data, null, 2));
}).catch((err) => {
  console.log(err);
});

cURL

curl -v "https://businesscommunications.googleapis.com/v1/brands/-/agents" \
  -H "Content-Type: application/json" \
  -H "User-Agent: curl/business-messaging" \
  -H "`oauth2l header --json serviceAccount.json businesscommunications`"

ระบบตั้งค่าแบรนด์เป็น - เนื่องจากไม่จำเป็นต้องระบุเมื่อดึงข้อมูลรายการ Agent ทั้งหมด

โค้ดนี้จะแสดงรายชื่อตัวแทนทั้งหมดที่ส่งสำหรับการเปิดตัวกับผู้ให้บริการ

{
  "agents": [
    {
      "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_4fpd1psz_agent",
      "displayName": "My new agent",
      "rcsBusinessMessagingAgent": {
        "description": "This is the agent description that will be displayed in the Agent info tab in Messages",
        "logoUri": "https://agent-logos.storage.googleapis.com/_/kt90w53vzw2QSxK6PG1uCeJf",
        "heroUri": "https://agent-logos.storage.googleapis.com/_/kt90vzob74GQcfeHoEQbVRTP",
        "phoneNumbers": [
          {
            "phoneNumber": {
              "number": "+12223334444"
            },
            "label": "Call support"
          }
        ],
        "privacy": {
          "uri": "https://policies.google.com/privacy",
          "label": "Our privacy policy"
        },
        "termsConditions": {
          "uri": "https://policies.google.com/terms",
          "label": "Our Terms and Conditions"
        },
        "color": "#0B78D0",
        "billingConfig": {
          "billingCategory": "BASIC_MESSAGE"
        },
        "agentUseCase": "MULTI_USE",
        "hostingRegion": "NORTH_AMERICA"
      }
    },
    {
      "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_7jo0trhw_agent",
      "displayName": "My second agent",
      "rcsBusinessMessagingAgent": {
        "description": "Another agent description",
        "logoUri": "https://agent-logos.storage.googleapis.com/_/kt90w53vzw2QSxK6PG1uCeJf",
        "heroUri": "https://agent-logos.storage.googleapis.com/_/kt90vzob74GQcfeHoEQbVRTP",
        "phoneNumbers": [
          {
            "phoneNumber": {
              "number": "+12228885768"
            },
            "label": "Call support"
          }
        ],
        "privacy": {
          "uri": "https://policies.google.com/privacy",
          "label": "Our privacy policy"
        },
        "termsConditions": {
          "uri": "https://policies.google.com/terms",
          "label": "Our Terms and Conditions"
        },
        "color": "#0B78D0",
        "billingConfig": {
          "billingCategory": "CONVERSATIONAL_LEGACY"
        },
        "agentUseCase": "PROMOTIONAL",
        "hostingRegion": "NORTH_AMERICA"
      }
    }
  ]
}

โดยจะเรียกข้อมูลผลลัพธ์ได้ครั้งละ 1 หน้า ดูรายละเอียดได้ที่เอกสารอ้างอิง API

ดูสถานะการเปิดใช้งานตัวแทนและแบบสอบถาม

ผู้ให้บริการจะดูสถานะการเปิดใช้งานปัจจุบันของตัวแทนและแบบสอบถามการเปิดใช้งานของนักพัฒนาแอปได้

Node.js

const businessCommunicationsApiHelper =
  require('@google/rbm-businesscommunications');

const privateKey =
  require('../../resources/businesscommunications-service-account-credentials.json');

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper.getAgentLaunch(agents[0].name).then((response) => {
  console.log('Launch details are:');
  console.log(JSON.stringify(response.data, null, 2));
}).catch((err) => {
  console.log(err);
});

cURL

curl -v "https://businesscommunications.googleapis.com/v1/brands/-/agents/AGENT ID/launch" \
  -H "Content-Type: application/json" \
  -H "User-Agent: curl/business-messaging" \
  -H "`oauth2l header --json serviceAccount.json businesscommunications`"

ผู้โทรไม่จำเป็นต้องมีชื่อเต็มของตัวแทน ซึ่งรวมถึงชื่อแบรนด์ด้วย ต้องระบุเฉพาะรหัสตัวแทน (ก่อน @rbm.goog) โดยตั้งชื่อแบรนด์เป็น -

โค้ดนี้จะแสดงข้อมูลการเปิดตัวดังนี้

{
  "name": "brands/8b5c7f80-b025-486b-bc8a-2d0797559711/agents/my-agent-demo/launch",
  "rcsBusinessMessaging": {
    "questionnaire": {
      "contacts": [
        {
          "name": "John Doe",
          "title": "Mr",
          "email": "johndoe@developer.com"
        }
      ],
      "optinDescription": "Messages are sent to known MSISDNs",
      "triggerDescription": "We respond to any interaction",
      "interactionsDescription": "Simple conversations with a chatbot",
      "optoutDescription": "User sends stop"
    },
    "launchDetails": {
      "/v1/regions/thecarrier": {
        "launchState": "LAUNCH_STATE_LAUNCHED",
        "updateTime": "2023-02-20T15:10:36.528669Z"
      }
    }
  }
}

ดึงข้อมูลคำจำกัดความของ Agent

คุณดึงข้อมูลของตัวแทนได้โดยใช้ตัวระบุที่ไม่ซ้ำกัน (name)

Node.js

const businessCommunicationsApiHelper =
  require('@google/rbm-businesscommunications');

const privateKey =
  require('../../resources/businesscommunications-service-account-credentials.json');

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper.getAgent(agent[0].name).then((response) => {
  console.log('Agent details are:');
  console.log(JSON.stringify(response.data, null, 2));
}).catch((err) => {
  console.log(err);
});

cURL

curl -v "https://businesscommunications.googleapis.com/v1/brands/-/agents/AGENT ID" \
  -H "Content-Type: application/json" \
  -H "User-Agent: curl/business-messaging" \
  -H "`oauth2l header --json serviceAccount.json businesscommunications`"

ผู้โทรไม่จำเป็นต้องมีชื่อเต็มของตัวแทน รวมถึงชื่อแบรนด์ ต้องระบุเฉพาะรหัสตัวแทน (ก่อน @rbm.goog) โดยตั้งชื่อแบรนด์เป็น -

โค้ดนี้จะแสดงข้อมูลตัวแทน ดังนี้

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_4fpd1psz_agent",
  "displayName": "My new agent",
  "rcsBusinessMessagingAgent": {
    "description": "This is the agent description that will be displayed in the Agent info tab in Messages",
    "logoUri": "https://agent-logos.storage.googleapis.com/_/kt90w53vzw2QSxK6PG1uCeJf",
    "heroUri": "https://agent-logos.storage.googleapis.com/_/kt90vzob74GQcfeHoEQbVRTP",
    "phoneNumbers": [
      {
        "phoneNumber": {
          "number": "+12223334444"
        },
        "label": "Call support"
      }
    ],
    "privacy": {
      "uri": "https://policies.google.com/privacy",
      "label": "Our privacy policy"
    },
    "termsConditions": {
      "uri": "https://policies.google.com/terms",
      "label": "Our Terms and Conditions"
    },
    "color": "#0B78D0",
    "billingConfig": {
      "billingCategory": "BASIC_MESSAGE"
    },
    "agentUseCase": "MULTI_USE",
    "hostingRegion": "NORTH_AMERICA"
  }
}

เปลี่ยนสถานะการเปิดใช้งานของตัวแทน

ผู้ให้บริการสามารถอัปเดตสถานะการเปิดใช้ของเอเจนต์และเพิ่มข้อความที่จะส่งถึงนักพัฒนาซอฟต์แวร์ได้

สถานะควรเปลี่ยนแปลงดังนี้

  • LAUNCH_STATE_PENDING ไปยัง LAUNCH_STATE_LAUNCHED หรือ LAUNCH_STATE_REJECTED
  • LAUNCH_STATE_LAUNCHED ถึง LAUNCH_STATE_SUSPENDED
  • LAUNCH_STATE_SUSPENDED ไปยัง LAUNCH_STATE_LAUNCHED หรือ LAUNCH_STATE_REJECTED

ผู้โทรไม่จำเป็นต้องมีชื่อเต็มของตัวแทน รวมถึงชื่อแบรนด์ ต้องระบุเฉพาะรหัสตัวแทน (ก่อน @rbm.goog) โดยตั้งชื่อแบรนด์เป็น -

Node.js

const businessCommunicationsApiHelper =
  require('@google/rbm-businesscommunications');

const privateKey =
  require('../../resources/businesscommunications-service-account-credentials.json');

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper
	.updateAgentLaunchState(agentId, 'LAUNCH_STATE_LAUNCHED').then((response) => {
		console.log('Updated launch details are:');
		console.log(JSON.stringify(response.data, null, 2));
	});

cURL

curl -v -X PATCH "https://businesscommunications.googleapis.com/v1/brands/-/agents/AGENT ID/launch" \
  -H "Content-Type: application/json" \
  -H "User-Agent: curl/business-messaging" \
  -H "`oauth2l header --json serviceAccount.json businesscommunications`" \
  -d "{
    'rcsBusinessMessaging': {
      'launchDetails': {
        '': {
          'launchState': 'LAUNCH_STATE_LAUNCHED',
        }
      }
    }
  }"

โค้ดนี้จะแสดงข้อมูลการเปิดตัวที่อัปเดตแล้วซึ่งสถานะการเปิดตัวมีการเปลี่ยนแปลง

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_4fpd1psz_agent/launch",
  "rcsBusinessMessaging": {
    "questionnaire": {
      "contacts": [
        {
          "name": "Ian",
          "title": "The Boss",
          "email": "someone@somewhere.com"
        }
      ],
      "optinDescription": "Users accepted our terms of service online.",
      "triggerDescription": "We are reaching preregistered users",
      "interactionsDescription": "This agent does not do much.",
      "optoutDescription": "Reply stop and we stop.",
      "agentAccessInstructions": "This is a a simple agent that reaches registered users.",
      "videoUris": [
        "https://www.google.com/a/video"
      ],
      "screenshotUris": [
        "https://www.google.com/a/screenshot"
      ]
    },
    "launchDetails": {
      "/v1/regions/thecarrier": {
        "launchState": "LAUNCH_STATE_REJECTED",
        "comment": "We don't have a billing contract in place with you.",
        "updateTime": "2023-04-28T15:22:10.221191Z"
      }
    }
  }
}

ลบตัวแทน

ลบตัวแทน RBM ไม่ได้อีกต่อไปเพื่อความปลอดภัย โปรดติดต่อทีมสนับสนุนของ RBM เพื่อขอความช่วยเหลือ