Kelola agen

Semua agen termasuk dalam merek (bisnis, organisasi, atau grup). Sebelum agen dapat dibuat, Anda harus membuat merek pemilik. Merek murni bersifat organisasi untuk membantu Anda mengelompokkan agen terkait

Cuplikan kode di halaman ini diambil dari contoh Java dan contoh Node.js.

Pembuatan dan definisi agen

Membuat agen

Untuk membuat agen RBM, Anda harus menentukan informasi dasarnya.

Untuk mengetahui detail selengkapnya, lihat brands.agents.create.

Catatan: Untuk menyederhanakan struktur penagihan, kami telah menggabungkan kategori penagihan Pesan Dasar dan Pesan Tunggal lama ke dalam satu kategori Non-percakapan. Tinjau FAQ Penagihan untuk mengetahui detail lengkap tentang migrasi agen yang ada dan jendela integrasi API.

cURL

curl -v -X POST "https://businesscommunications.googleapis.com/v1/$BRAND_ID/agents" \
  -H "Content-Type: application/json" \
  -H "User-Agent: curl/business-messaging" \
  -H "`oauth2l header --json rbm-developer-service-account-credentials.json businesscommunications`" \
  -d "{
    'displayName': 'My test agent',
    'rcsBusinessMessagingAgent': {
      'description': 'My agent description',
      'logoUri': 'https://agent-logos.storage.googleapis.com/_/kt90w53vzw2QSxK6PG1uCeJf',
      'heroUri': 'https://agent-logos.storage.googleapis.com/_/kt90vzob74GQcfeHoEQbVRTP',
      'phoneNumbers': [
        {
            'phoneNumber': {
                'number': '[phone]'
            },
            'label': 'My number'
        }
      ],
      'emails': [
        {
            'address': '[e-mail]',
            'label': 'My email'
        }
      ],
      'websites': [
        {
            'uri': 'https://a.demo.test/',
            'label': 'My site'
        }
      ],
      'privacy': {
        'uri': 'https://a.demo.test/privacy',
        'label': 'My privacy policy'
      },
      'termsConditions': {
        'uri': 'https://a.demo.test/terms',
        'label': 'My terms'
      },
      'color': '#FFFFFF',
      'billingConfig': {
        'billingCategory': 'CONVERSATIONAL'
      },
      'agentUseCase': 'TRANSACTIONAL',
      'hostingRegion': 'EUROPE'
    }
  }"

Kode ini adalah cuplikan dari contoh RBM Management API kami.

Node.js

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

const newAgentDetails = {
  displayName: 'My new agent',
  name: brandId + '/agents/',
  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: '[phone]'
        },
        label: 'Call support'
      }
    ],
    // It's recommended to provide at least one contact method (phone or email) because
    // this is required for launch. For any phone, email, or website provided, a corresponding label
    // must also be included.
    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: 'NON_CONVERSATIONAL' },
    agentUseCase: 'TRANSACTIONAL',
    hostingRegion: 'EUROPE'
  }
};

businessCommunicationsApiHelper.createAgent(brandId, newAgentDetails).then((response) => {

}).catch((err) => {
  console.log(err);
});

Java

Brand brand = api.getBrand(brandId);
logger.info("Brand to operate on: " + brand);
String displayName = flags.getOrDefault("agent_name", "Test RBM Agent: " + now.getSecond());
String suffix = flags.getOrDefault("agent_data_suffix", "API");
RcsBusinessMessagingAgent agentData = AgentFactory.createRbmAgent(suffix);
Agent agent = api.createRbmAgent(brand, displayName, agentData);
logger.info("RBM agent has been created: " + agent);

Kode ini menampilkan informasi agen baru dan ID unik yang ditetapkan ke agen:

{
  name: 'brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_dxuewtvy_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: [ [Object] ],
    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: 'NON_CONVERSATIONAL' },
    agentUseCase: 'MULTI_USE',
    hostingRegion: 'EUROPE'
  }
}

Mencari definisi agen

Anda dapat mengambil agen dengan menentukan ID uniknya (name). Untuk mengetahui detail selengkapnya, lihat brands.agents.list.

Node.js

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

// Retrieve details of the first agent (if one has already been created)
businessCommunicationsApiHelper.getAgent(agent.name).then((response) => {

}).catch((err) => {
  console.log(err);
});

Java

Agent agent = api.getAgent(flags.get("agent_id"));
logger.info("Agent: " + agent);

Kode ini menampilkan informasi agen:

{
  name: 'brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_dxuewtvy_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: [ [Object] ],
    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: 'NON_CONVERSATIONAL' },
    agentUseCase: 'MULTI_USE',
    hostingRegion: 'EUROPE'
  }
}

Verifikasi dan peluncuran

Mengirimkan informasi verifikasi

Peringatan: Contoh API yang disediakan di bagian ini hanya berlaku untuk model Satu partner. RBM Management API untuk memperbarui token verifikasi dalam model Multi-partner akan tersedia pada rilis mendatang.

Verifikasi merek diperlukan untuk peluncuran agen. Anda harus mengirimkan informasi verifikasi sebelum membuat permintaan peluncuran. Perhatikan bahwa Anda tidak perlu menunggu persetujuan merek sebelum membuat permintaan peluncuran. Persetujuan merek terjadi sebagai bagian dari proses persetujuan peluncuran. Untuk operator tertentu, Anda juga harus memberikan token verifikasi yang valid yang dikeluarkan oleh Otoritas Verifikasi.

Untuk mengetahui detail selengkapnya, lihat brands.agents.requestVerification.

cURL

curl -v "https://businesscommunications.googleapis.com/v1/brands/$BRAND_ID/agents/$AGENT_ID:requestVerification" \
-H "Content-Type: application/json" \
-H "x-http-method-override: POST" \
-H "User-Agent: curl/business-messaging" \
-H "$(oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications)" \
-d "{
  'agentVerificationContact': {
     ...
   },
   'agentVerificationToken':
     {'tokenBase64Encoded': '$TOKEN'}
}"

Node.js

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

let agentVerificationContact = {
  partnerName: 'Alice',
  partnerEmailAddress: '[e-mail]',
  brandContactName: 'Bob',
  brandContactEmailAddress: '[e-mail]',
  brandWebsiteUrl: 'https://thebrand.com/'
};

businessCommunicationsApiHelper.verifyAgent(agent.name, agentVerificationContact).then((response) => {

}).catch((err) => {
  console.log(err);
});

Java

AgentVerificationContact contact = AgentFactory.createRbmAgentVerification();
AgentVerification verification = api.requestAgentVerification(agent.getName(), contact);
logger.info("Verification requested: " + verification);

Kode ini menampilkan informasi verifikasi:

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_ciymyd2b_agent",
  "verificationState": "VERIFICATION_STATE_UNVERIFIED",
  "agentVerificationContact": {
    "partnerName": "Alice",
    "partnerEmailAddress": "[e-mail]",
    "brandContactName": "Bob",
    "brandContactEmailAddress": "[e-mail]",
    "brandWebsiteUrl": "https://thebrand.com/"
  },
  "agentVerificationTokens": [
    {
      "verificationAuthorityDisplayName": "Example Verification Authority",
      "expirationTime": "2027-06-16T13:45:14Z",
      "status": "ACTIVE",
      "countryCode": "US",
      "tokenBase64Encoded": "...",
      "certificateChainUri": "https://rbm.goog/certificates?v=5&kid=6CAE185529AABAC216565E99A8DE22504B086209"
    }
  ]
}

Mencari info verifikasi agen

Anda dapat mengambil status verifikasi merek agen. Untuk mengetahui detail selengkapnya, lihat brands.agents.getVerification.

Node.js

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper.getAgentVerification(agent.name).then((response) => {

}).catch((err) => {
  console.log(err);
});

Java

AgentVerification verification = api.getAgentVerification(agent.getName());
logger.info("RBM agent verification: " + verification);

Kode ini menampilkan status verifikasi dan info partner:

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_ciymyd2b_agent/verification",
  "verificationState": "VERIFICATION_STATE_UNVERIFIED",
  "agentVerificationContact": {
    "partnerName": "John Doe",
    "partnerEmailAddress": "[e-mail]",
    "brandContactName": "Bob",
    "brandContactEmailAddress": "[e-mail]",
    "brandWebsiteUrl": "https://www.brand.com"
  },
  "agentVerificationTokens": [
    {
      "verificationAuthorityDisplayName": "Example Verification Authority",
      "expirationTime": "2027-06-16T13:45:14Z",
      "status": "ACTIVE",
      "countryCode": "US",
      "tokenBase64Encoded": "...",
      "certificateChainUri": "https://rbm.goog/certificates?v=5&kid=6CAE185529AABAC216565E99A8DE22504B086209"
    }
  ]
}

Memperbarui dan menghapus token verifikasi

Jika memiliki agen yang sudah diluncurkan, Anda dapat memperbaruinya dengan token verifikasi. Untuk menambahkan atau memperbarui token, panggil metode updateVerification (menggunakan permintaan PATCH) dan tentukan mask update agent_verification_tokens.

cURL

curl -v -X PATCH "https://businesscommunications.googleapis.com/v1/brands/$BRAND_ID/agents/$AGENT_ID/verification?updateMask=agent_verification_tokens" \
-H "Content-Type: application/json" \
-H "x-http-method-override: PATCH" \
-H "User-Agent: curl/business-messaging" \
-H "$(oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications)" \
-d "{
   'agentVerificationTokens': [
     {'tokenBase64Encoded': '$TOKEN'}
   ]
}"

Jika agen Anda diluncurkan di beberapa negara, Anda mungkin perlu menentukan beberapa token (satu untuk setiap negara) yang dikeluarkan oleh otoritas verifikasi yang disetujui untuk wilayah tersebut. Untuk menentukan token tambahan, panggil metode updateVerification dan berikan semua token yang ingin Anda kaitkan dengan agen, termasuk token yang sudah dikaitkan dengannya.

Untuk menghapus semua token yang terkait dengan agen, kirim daftar kosong dalam permintaan PATCH Anda:

cURL

curl -v -X PATCH "https://businesscommunications.googleapis.com/v1/brands/$BRAND_ID/agents/$AGENT_ID/verification?updateMask=agent_verification_tokens" \
-H "Content-Type: application/json" \
-H "x-http-method-override: PATCH" \
-H "User-Agent: curl/business-messaging" \
-H "$(oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications)" \
-d "{}"

Memecahkan masalah error token verifikasi

Saat mengelola token verifikasi dan meminta peluncuran, Anda mungkin mengalami error berikut:

• Token tidak ada untuk peluncuran: Jika Anda meminta peluncuran di operator yang memerlukan token, tetapi agen tidak memilikinya, Anda akan menerima 400 error (misalnya, "Verification token matching agent <...> and carrier country US is missing").
• Data agen tidak cocok: ID agen, nama agen, logo, dan banner di profil agen Anda harus sama persis dengan data yang disematkan dalam token. Jika Anda mencoba melampirkan token yang tidak cocok, atau meminta peluncuran dengan token yang tidak cocok, Anda akan menerima 400 error (misalnya, "Agent ID mismatch. Request agent ID: <...>, Token agent ID: <...>").

Mengirimkan agen untuk peluncuran

Anda dapat mengirimkan agen untuk peluncuran di satu atau beberapa operator. Beberapa peluncuran dikelola oleh Google dan yang lainnya dikelola langsung oleh operator. Peluncuran yang dikelola operator mungkin memiliki persyaratan tambahan. Lihat Peluncuran yang dikelola Google vs. Peluncuran yang dikelola operator untuk mengetahui informasi selengkapnya.

Sebelum dapat meluncurkan agen untuk pertama kalinya, Anda harus mengirimkan informasi verifikasi. Hal ini memungkinkan Google, operator, atau keduanya memverifikasi dengan kontak merek Anda bahwa Anda diizinkan untuk mengelola agen atas nama mereka. Lihat verifikasi merek untuk mengetahui detailnya.

Setelah mengirimkan informasi verifikasi dan menyelesaikan prasyarat peluncuran, Anda dapat mengirimkan permintaan peluncuran.

Anda dapat mengirimkan agen untuk peluncuran di satu atau beberapa operator. Kuesioner peluncuran yang telah diisi harus diberikan sebagai bagian dari permintaan peluncuran. Untuk mengetahui detail selengkapnya, lihat brands.agents.requestLaunch.

cURL

curl -v -X POST "https://businesscommunications.googleapis.com/v1/$AGENT_ID:requestLaunch" \
  -H "Content-Type: application/json" \
  -H "User-Agent: curl/business-messaging" \
  -H "`oauth2l header --json rbm-developer-service-account-credentials.json businesscommunications`" \
  -d "{
    'agentLaunch': {
      'rcsBusinessMessaging': {
        'questionnaire': {
          'contacts': [
            {
              'name': 'John Doe',
              'title': 'Product Owner',
              'email': '[e-mail]'
            }
          ],
          'optinDescription': 'Thanks for your request.',
          'triggerDescription': 'Promotional messages will be triggered in a timely manner.',
          'interactionsDescription': 'Promotional messages are one way.',
          'optoutDescription': 'Sorry to see you go.',
          'agentAccessInstructions': 'Thanks for your request.',
          'videoUris': [
            'https://d2q4iodazzzt8b.cloudfront.net/MicrosoftTeamsvideo2_1758533835.mp4'
          ],
          'screenshotUris': [
            'https://rm.virbm.com/Il9ChvVEhS1na5mr/ee9bc94b468a40688fb7fc71cb1c069c.png'
          ]
        },
        'launchDetails': {
          '/v1/regions/$CARRIER_ID': {}
        }
      }
    }
  }"

Kode ini adalah cuplikan dari contoh RBM Management API kami.

Node.js

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);
  
let agentLaunch = {
  questionnaire: {
    contacts: [
      {
        name: 'James Bond',
        title: 'Mr 0 0 7',
        email: '[e-mail]'
      }
    ],
    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: {}
};

businessCommunicationsApiHelper.launchAgent(agent.name, agentLaunch).then((response) => {

}).catch((err) => {
  console.log(err);
});

Java

Optional<Questionnaire> q = Optional.of(AgentFactory.createRbmQuestionnaire());
AgentLaunch launch = api.requestRbmAgentLaunch(agent.getName(), regionIds, q);
logger.info("RBM agent updated launch: " + launch);

Kode ini menampilkan informasi peluncuran agen:

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_7jo0trhw_agent/launch",
  "rcsBusinessMessaging": {
    "questionnaire": {
      "contacts": [
        {
          "name": "James Bond",
          "title": "Mr O O 7",
          "email": "[e-mail]"
        }
      ],
      "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/some-carrier": {
        "launchState": "LAUNCH_STATE_PENDING",
        "updateTime": "2023-02-24T15:02:13.903554Z"
      }
    },
    "launchRegion": "NORTH_AMERICA"
  }
}

Perhatikan bahwa launchRegion tidak digunakan lagi dan dijadwalkan untuk segera dihapus.

Meluncurkan agen ke satu atau beberapa region

Untuk meluncurkan agen ke satu atau beberapa region, jika agen belum diluncurkan sebelumnya, panggil metode requestLaunch dengan objek yang berisi peta hanya kunci untuk semua region yang ingin Anda luncurkan. Penggunaan peta kosong memungkinkan untuk mempertahankan konsistensi API internal dalam objek yang digunakan di antara panggilan API.

curl -X POST \
"https://businesscommunications.googleapis.com/v1/brands/BRAND_ID/agents/AGENT_ID:requestLaunch" \
-H "Content-Type: application/json" \
-H "$(oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications)" \
-d "{
  'name': 'brands/BRAND_ID/agents/AGENT_ID/launch',
  'rcsBusinessMessaging': {
    'questionnaire': {
      'contacts': [
        {
          'name': 'Contact person 000',
          'title': 'Contact manager 000',
          'email': '[e-mail]000'
        }
      ],
      'optinDescription': 'Opt-in description 0',
      'triggerDescription': 'Trigger description 0',
      'optoutDescription': 'Opt-out description 0',
      'agentAccessInstructions': 'Agent instructions 0',
      'videoUris': [
        'https://www.youtube.com/watch?v=NN75im_us4k'
      ],
      'screenshotUris': [
        'https://www.youtube.com/watch?v=NN75im_us4k'
      ]
    },
    'launchDetails': {
      '/v1/regions/fi-rcs': {}
    }
  }
}"

Untuk meluncurkan agen ke satu atau beberapa region (jika agen sudah diluncurkan sebelumnya), panggil metode requestLaunch dengan objek yang berisi peta hanya kunci dari semua region tempat agen sudah diluncurkan dan semua region yang ingin diluncurkan oleh agen. Penggunaan peta kosong memungkinkan untuk mempertahankan konsistensi API internal dalam objek yang digunakan di antara panggilan API.

curl -X POST \
"https://businesscommunications.googleapis.com/v1/brands/BRAND_ID/agents/AGENT_ID:requestLaunch" \
-H "Content-Type: application/json" \
-H "$(oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications)" \
-d "{
  'name': 'brands/BRAND_ID/agents/AGENT_ID/launch',
  'rcsBusinessMessaging': {
    'launchDetails': {
      '/v1/regions/fi-rcs': {},
      '/v1/regions/vodafone-idea-india': {}
    }
  }
}"

Jika agen memanggil metode requestLaunch, tetapi tidak menyertakan semua region tempat agen sudah diluncurkan sebagai kunci, error 400 - Bad Request akan ditampilkan.

Mencari status peluncuran agen

Anda dapat mengambil status peluncuran agen saat ini. Untuk mengetahui detail selengkapnya, lihat brands.agents.getLaunch.

Node.js

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper.getAgentLaunch(agent.name).then((response) => {

}).catch((err) => {
  console.log(err);
});

Java

AgentLaunch launch = api.getAgentLaunch(agent.getName());
logger.info("RBM agent launch: " + launch);

Jika peluncuran ditolak oleh operator, partner dapat meminta peluncuran pada operator lagi (permintaan memiliki status UNSPECIFIED dan backend memiliki status REJECTED).

Kode ini menampilkan informasi peluncuran dan status peluncuran untuk setiap operator target:

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_7jo0trhw_agent/launch",
  "rcsBusinessMessaging": {
    "questionnaire": {
      "contacts": [
        {
          "name": "James Bond",
          "title": "Mr O O 7",
          "email": "[e-mail]"
        }
      ],
      "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/some-carrier": {
        "launchState": "LAUNCH_STATE_PENDING",
        "updateTime": "2023-02-24T15:02:13.903554Z"
      }
    },
    "launchRegion": "NORTH_AMERICA"
  }
}

Perhatikan bahwa launchRegion tidak digunakan lagi dan dijadwalkan untuk segera dihapus.

Menambahkan operator lain ke peluncuran agen

Setelah mengambil informasi peluncuran saat ini untuk agen Anda menggunakan panggilan API brands.agents.getLaunch, Anda dapat menambahkan lebih banyak operator target untuk memperluas jangkauan agen. Untuk mengetahui detail selengkapnya, lihat brands.agents.updateLaunch.

Node.js

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);');

// To launch an agent to further carriers, we need to first obtain the existing
// launch information and extend it with the new carrier(s).
businessCommunicationsApiHelper.getAgentLaunch(agent.name).then((response) => {
  let existingLaunch = response.data.rcsBusinessMessaging;

  // Now we add the new carrier to the existing launch
  existingLaunch.launchDetails[config.launchCarrier2] = null;

  // And we submit the launch again
  businessCommunicationsApiHelper.launchAgent(agent.name, existingLaunch).then((response) => {
    console.log('Launch details are:');
    console.log(JSON.stringify(response.data, null, 2));
  }).catch((err) => {
    console.log(err);
  });
}).catch((err) => {
  console.log(err);
});

Kode ini menampilkan informasi peluncuran yang diperbarui:

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_7jo0trhw_agent/launch",
  "rcsBusinessMessaging": {
    "questionnaire": {
      "contacts": [
        {
          "name": "James Bond",
          "title": "Mr O O 7",
          "email": "[e-mail]"
        }
      ],
      "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/some-carrier": {
        "launchState": "LAUNCH_STATE_PENDING",
        "updateTime": "2023-02-24T15:02:13.903554Z"
      },
      "/v1/regions/another-carrier": {
        "launchState": "LAUNCH_STATE_PENDING",
        "updateTime": "2023-02-24T15:04:50.456552Z"
      }
    },
    "launchRegion": "NORTH_AMERICA"
  }
}

Pasca-peluncuran dan pemeliharaan

Membuat daftar semua agen yang dibuat untuk merek

Developer dapat mengambil daftar semua agen yang telah mereka buat untuk merek. Untuk mengetahui detail selengkapnya, lihat brands.agents.list.

Node.js

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper.listAgents(brand.name).then((response) => {
  console.log('Current agents are:');
  console.log(response.data);
  datastore.saveJsonData('agents', response.data.agents);
}).catch((err) => {
  console.log(err);
});

Java

Brand brand = api.getBrand(brandId);
logger.info("Brand: " + brand);
ListAgentsResponse response = api.listAllAgents(brand);
List<Agent> agents = response.getAgents().stream()
  .sorted(Comparator.comparing(Agent::getName)).collect(Collectors.toList());
logger.info(String.format("Found %d agents", response.getAgents().size()));
for (Agent agent : agents) {
  logger.info(String.format("Agent [%s]: '%s'", agent.getName(), agent.getDisplayName()));
}

Kode ini menampilkan daftar semua agen yang dimiliki oleh merek:

{
  agents: [
    {
      name: 'brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_4fpd1psz_agent',
      displayName: 'My new agent',
      rcsBusinessMessagingAgent: [Object]
    },
    {
      name: 'brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_ciymyd2b_agent',
      displayName: 'My second agent',
      rcsBusinessMessagingAgent: [Object]
    },
    {
      name: 'brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_helof85o_agent',
      displayName: 'My third agent',
      rcsBusinessMessagingAgent: [Object]
    }
  ]
}

Menyertakan agen yang diarsipkan

Secara default, daftar semua agen tidak menyertakan agen yang telah diarsipkan oleh partner. Untuk menyertakan agen yang diarsipkan dalam hasil, tetapkan parameter includeArchived ke true.

Node.js

Metode `listAgents` menerima objek konfigurasi opsional untuk menyertakan agen yang diarsipkan.

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

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

businessCommunicationsApiHelper.initBusinessCommunicationsApi(privateKey);

// To list all agents including archived ones, set includeArchived to true
const listOptions = {
  includeArchived: true
};

businessCommunicationsApiHelper.listAgents(brand.name, listOptions).then((response) => {
 console.log('Current agents (including archived) are:');
 console.log(response.data);
 datastore.saveJsonData('agents', response.data.agents);
}).catch((err) => {
 console.log(err);
});

Java

Metode `listAllAgents` menyertakan parameter boolean untuk kontrol visibilitas.

// To list all agents including archived ones, pass 'true' for the includeArchived parameter
boolean includeArchived = true;
Brand brand = api.getBrand(brandId);
logger.info("Brand: " + brand);

// Call listAllAgents with the brand and the includeArchived flag
ListAgentsResponse response = api.listAllAgents(brand, includeArchived);

List agents = response.getAgents().stream()
 .sorted(Comparator.comparing(Agent::getName)).collect(Collectors.toList());

logger.info(String.format("Found %d agents (including archived)", response.getAgents().size()));
for (Agent agent : agents) {
 logger.info(String.format("Agent [%s]: '%s' (Archived: %s)",
    agent.getName(), agent.getDisplayName(), agent.getIsArchived()));
}

Membatalkan peluncuran agen

Untuk membatalkan peluncuran agen dari region tertentu, panggil metode updateLaunch, tentukan region target dalam peta panggilan, dan tetapkan launchState ke LAUNCH_STATE_UNLAUNCHED.

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/BRAND_ID/agents/AGENT_ID/launch" \
-H "Content-Type: application/json" \
-H "$(oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications)" \
-d "{
  'rcsBusinessMessaging': {
    'launchDetails': {
      '/v1/regions/fi-rcs': {
        'launchState': 'LAUNCH_STATE_UNLAUNCHED'
      },
      '/v1/regions/vodafone-idea-india': {
        'launchState': 'LAUNCH_STATE_UNLAUNCHED'
      }
    }
  }
}"

Menghapus agen

Karena alasan keamanan, agen RBM tidak dapat lagi dihapus. Untuk mendapatkan bantuan, hubungi tim dukungan RCS for Business.

Mengarsipkan atau membatalkan pengarsipan agen

Untuk mempertahankan ruang kerja yang bersih dan teratur, Anda dapat mengarsipkan agen yang tidak lagi digunakan. Mengarsipkan agen akan menyembunyikannya dari hasil penemuan API default.

Pengarsipan hanya merupakan perubahan visibilitas. Tindakan ini tidak menghapus agen atau memengaruhi status peluncuran yang mendasarinya. Anda dapat membatalkan pengarsipan agen kapan saja untuk memulihkan visibilitasnya dan melanjutkan pengelolaan.

Catatan: Untuk mengarsipkan atau membatalkan pengarsipan agen menggunakan Konsol Developer RCS for Business , lihat Mengarsipkan atau membatalkan pengarsipan agen.

Untuk memastikan bahwa agen aktif tidak tersembunyi secara tidak sengaja, aturan berikut berlaku:

• Kelayakan: Anda hanya dapat mengarsipkan agen yang dalam status tidak aktif: UNLAUNCHED, SUSPENDED, atau REJECTED.
• Pembatasan: Anda tidak dapat mengarsipkan agen yang LAUNCHED atau PENDING di operator mana pun. Jika Anda mencoba mengarsipkan agen tersebut, permintaan akan ditolak dengan error.

Memperbarui status arsip

Untuk mengarsipkan atau membatalkan pengarsipan agen, gunakan metode patch. Anda harus menyertakan parameter updateMask=is_archived di URL untuk menentukan kolom yang diperbarui. Untuk mengarsipkan, tetapkan boolean isArchived ke true, dan untuk membatalkan pengarsipan, tetapkan ke false.

Metode: PATCH /v1/brands/{brandId}/agents/{agentId} Tambahkan is_archived ke mask update.

{
  "isArchived": true
}

Membuat daftar agen dengan filter

Secara default, metode list menyembunyikan agen yang diarsipkan. Untuk menyertakannya dalam hasil, gunakan parameter include_archived.

Metode: GET /v1/brands/{brandId}/agents?include_archived=true