এজেন্টদের পরিচালনা করুন

সকল এজেন্ট একটি ব্র্যান্ডের (ব্যবসা, সংস্থা বা গোষ্ঠী) অন্তর্ভুক্ত। একটি এজেন্ট তৈরি করার আগে, একটি মালিকানা ব্র্যান্ড তৈরি করা আবশ্যক। ব্র্যান্ডগুলো সম্পূর্ণরূপে সাংগঠনিক, যা আপনাকে সম্পর্কিত এজেন্টদের একত্রিত করতে সাহায্য করে।

এই পৃষ্ঠার কোড স্নিপেটগুলো জাভা স্যাম্পল এবং নোড.জেএস স্যাম্পল থেকে নেওয়া হয়েছে।

এজেন্ট তৈরি এবং সংজ্ঞা

একজন এজেন্ট তৈরি করুন

একটি RBM এজেন্ট তৈরি করতে, আপনাকে এর মৌলিক তথ্য নির্ধারণ করতে হবে।

আরও বিস্তারিত তথ্যের জন্য brands.agents.create দেখুন।

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': '+44800088088'
            },
            'label': 'My number'
        }
      ],
      'emails': [
        {
            'address': 'support@demo.test',
            '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'
    }
  }"
 এই কোডটি আমাদের RBM ম্যানেজমেন্ট API স্যাম্পল থেকে নেওয়া একটি অংশ।

নোড.জেএস 

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: '+12223334444'
        },
        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);
});

জাভা 

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);

এই কোডটি নতুন এজেন্টের তথ্য এবং এজেন্টকে বরাদ্দ করা একটি অনন্য শনাক্তকারী ফেরত দেয়:

{
  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'
  }
}

এজেন্টের সংজ্ঞা খুঁজে দেখুন

আপনি এজেন্টের অনন্য শনাক্তকারী ( name ) উল্লেখ করে তাকে খুঁজে পেতে পারেন। আরও বিস্তারিত তথ্যের জন্য brands.agents.list দেখুন।

নোড.জেএস 

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);
});

জাভা 

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

এই কোডটি এজেন্টের তথ্য ফেরত দেয়:

{
  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'
  }
}

যাচাইকরণ এবং চালু

যাচাইকরণ তথ্য জমা দিন

এজেন্ট লঞ্চের জন্য ব্র্যান্ড যাচাইকরণ প্রয়োজন। লঞ্চের অনুরোধ করার আগে আপনাকে অবশ্যই যাচাইকরণ তথ্য জমা দিতে হবে। মনে রাখবেন, লঞ্চের অনুরোধ করার আগে আপনাকে ব্র্যান্ড অনুমোদনের জন্য অপেক্ষা করতে হবে না; লঞ্চ অনুমোদন প্রক্রিয়ার অংশ হিসেবেই ব্র্যান্ড অনুমোদন সম্পন্ন হয়।

আরও বিস্তারিত জানতে brands.agents.requestVerification দেখুন।

নোড.জেএস 

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

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

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

let agentVerificationContact = {
  partnerName: 'Alice',
  partnerEmailAddress: 'alice@thepartner.com',
  brandContactName: 'Bob',
  brandContactEmailAddress: 'bob@thebrand.com',
  brandWebsiteUrl: 'https://thebrand.com/'
};

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

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

জাভা 

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

এই কোডটি যাচাইকরণ তথ্য ফেরত দেয়: 

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_ciymyd2b_agent",
  "verificationState": "VERIFICATION_STATE_UNVERIFIED",
  "agentVerificationContact": {
    "partnerName": "Alice",
    "partnerEmailAddress": "alice@thepartner.com",
    "brandContactName": "Bob",
    "brandContactEmailAddress": "bob@thebrand.com",
    "brandWebsiteUrl": "https://thebrand.com/"
  }
}

একজন এজেন্টের যাচাইকরণ তথ্য খুঁজে দেখুন

আপনি কোনো এজেন্টের ব্র্যান্ড যাচাইকরণের অবস্থা জানতে পারবেন। আরও বিস্তারিত জানতে brands.agents.getVerification দেখুন।

নোড.জেএস 

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);
});

জাভা 

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

এই কোডটি যাচাইকরণের অবস্থা এবং অংশীদারের তথ্য ফেরত দেয়: 

{
  "name": "brands/40bd963f-ff92-425c-b273-8f0892d2d017/agents/my_new_agent_ciymyd2b_agent/verification",
  "verificationState": "VERIFICATION_STATE_UNVERIFIED",
  "agentVerificationContact": {
    "partnerName": "John Doe",
    "partnerEmailAddress": "john.doe@gmail.com",
    "brandContactName": "Bob",
    "brandContactEmailAddress": "bob@brand.com",
    "brandWebsiteUrl": "https://www.brand.com"
  }
}

লঞ্চের জন্য একজন এজেন্ট জমা দিন

আপনি এক বা একাধিক ক্যারিয়ারে লঞ্চ করার জন্য একটি এজেন্ট জমা দিতে পারেন। কিছু লঞ্চ গুগল দ্বারা পরিচালিত হয় এবং অন্যগুলো সরাসরি ক্যারিয়ার দ্বারা পরিচালিত হয়। ক্যারিয়ার-পরিচালিত লঞ্চগুলোর জন্য অতিরিক্ত কিছু শর্ত থাকতে পারে। আরও তথ্যের জন্য ‘গুগল-পরিচালিত বনাম ক্যারিয়ার-পরিচালিত লঞ্চ’ দেখুন।

প্রথমবার কোনো এজেন্ট চালু করার আগে, আপনাকে যাচাইকরণ তথ্য জমা দিতে হবে। এর মাধ্যমে গুগল, ক্যারিয়ার বা উভয়ই আপনার ব্র্যান্ড কন্ট্যাক্টের সাথে যাচাই করে নিতে পারে যে, আপনি তাদের পক্ষ থেকে এজেন্টটি পরিচালনা করার জন্য অনুমোদিত। বিস্তারিত জানতে ব্র্যান্ড ভেরিফিকেশন দেখুন।

একবার আপনি যাচাইকরণ তথ্য জমা দিয়ে এবং লঞ্চের পূর্বশর্তগুলো পূরণ করে ফেললে, আপনি একটি লঞ্চ অনুরোধ জমা দিতে পারবেন।

আপনি এক বা একাধিক ক্যারিয়ারে লঞ্চের জন্য একজন এজেন্টকে জমা দিতে পারেন। লঞ্চ অনুরোধের অংশ হিসেবে পূরণ করা লঞ্চ প্রশ্নাবলী অবশ্যই প্রদান করতে হবে। আরও বিস্তারিত জানতে 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': 'support@demo.test'
            }
          ],
          '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': {}
        }
      }
    }
  }"
 এই কোডটি আমাদের RBM ম্যানেজমেন্ট API স্যাম্পল থেকে নেওয়া একটি অংশ।

নোড.জেএস 

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: '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: {}
};

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

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

জাভা 

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

এই কোডটি এজেন্ট চালুর তথ্য ফেরত দেয়: 

{
  "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": "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/some-carrier": {
        "launchState": "LAUNCH_STATE_PENDING",
        "updateTime": "2023-02-24T15:02:13.903554Z"
      }
    },
    "launchRegion": "NORTH_AMERICA"
  }
}

উল্লেখ্য যে, launchRegion এখন অপ্রচলিত এবং শীঘ্রই এটি সরিয়ে ফেলা হবে।

এক বা একাধিক অঞ্চলে একজন এজেন্ট চালু করুন

এক বা একাধিক অঞ্চলে কোনো এজেন্ট চালু করতে, যদি এজেন্টটি আগে চালু না হয়ে থাকে , তাহলে requestLaunch মেথডটি এমন একটি অবজেক্ট দিয়ে কল করুন যাতে শুধুমাত্র সেই সমস্ত অঞ্চলের কী (key) সহ একটি ম্যাপ থাকবে যেখানে আপনি এজেন্টটি চালু করতে চান। একটি খালি ম্যাপ ব্যবহার করলে বিভিন্ন এপিআই কলের মধ্যে ব্যবহৃত অবজেক্টগুলিতে অভ্যন্তরীণ এপিআই সামঞ্জস্য বজায় রাখা সম্ভব হয়। 

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': 'user@domain.com000'
        }
      ],
      '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': {}
    }
  }
}"

এক বা একাধিক অঞ্চলে কোনো এজেন্ট চালু করতে (যদি এজেন্টটি আগে চালু করা হয়ে থাকে ), `requestLaunch` মেথডটি এমন একটি অবজেক্টসহ কল ​​করুন, যেটিতে শুধুমাত্র সেইসব অঞ্চলের কী-গুলোসহ একটি ম্যাপ থাকবে যেখানে এজেন্টটি ইতিমধ্যে চালু আছে এবং সেইসব অঞ্চলের কী-গুলো থাকবে যেখানে এজেন্টটি চালু হতে চায়। একটি খালি ম্যাপ ব্যবহার করলে বিভিন্ন এপিআই কলের মধ্যে ব্যবহৃত অবজেক্টগুলোতে অভ্যন্তরীণ এপিআই সামঞ্জস্য বজায় রাখা সম্ভব হয়। 

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': {}
    }
  }
}"

যদি কোনো এজেন্ট requestLaunch মেথডটি কল করে কিন্তু এজেন্টটি ইতিমধ্যে চালু করা সমস্ত অঞ্চলকে কী (key) হিসেবে অন্তর্ভুক্ত না করে, তাহলে একটি 400 - Bad Request ত্রুটি প্রদর্শিত হয়।

একজন এজেন্টের লঞ্চ স্ট্যাটাস দেখুন

আপনি একজন এজেন্টের বর্তমান লঞ্চ স্ট্যাটাস জানতে পারবেন। আরও বিস্তারিত জানতে brands.agents.getLaunch দেখুন।

নোড.জেএস 

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);
});

জাভা 

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

যদি ক্যারিয়ার কর্তৃক কোনো লঞ্চ প্রত্যাখ্যান করা হয়, তবে একজন পার্টনার ক্যারিয়ারটিতে পুনরায় লঞ্চের জন্য অনুরোধ করতে পারেন (অনুরোধটির অবস্থা UNSPECIFIED এবং ব্যাকএন্ডের অবস্থা REJECTED থাকে)।

এই কোডটি প্রতিটি টার্গেট ক্যারিয়ারের জন্য উৎক্ষেপণের তথ্য এবং উৎক্ষেপণের অবস্থা ফেরত দেয়: 

{
  "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": "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/some-carrier": {
        "launchState": "LAUNCH_STATE_PENDING",
        "updateTime": "2023-02-24T15:02:13.903554Z"
      }
    },
    "launchRegion": "NORTH_AMERICA"
  }
}

উল্লেখ্য যে, launchRegion এখন আর ব্যবহারযোগ্য নয় এবং শীঘ্রই এটি সরিয়ে ফেলা হবে।

একজন এজেন্টের লঞ্চে অতিরিক্ত ক্যারিয়ার যোগ করুন

brands.agents.getLaunch API কলটি ব্যবহার করে আপনার এজেন্টের বর্তমান লঞ্চের তথ্য পাওয়ার পর, আপনি আপনার এজেন্টের নাগাল প্রসারিত করতে আরও টার্গেট ক্যারিয়ার যোগ করতে পারেন। আরও বিস্তারিত জানতে, brands.agents.updateLaunch দেখুন।

নোড.জেএস 

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);
});

এই কোডটি আপডেট করা লঞ্চের তথ্য ফেরত দেয়: 

{
  "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": "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/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"
  }
}

উৎক্ষেপণ পরবর্তী এবং রক্ষণাবেক্ষণ

একটি ব্র্যান্ডের জন্য তৈরি করা সমস্ত এজেন্টের তালিকা

ডেভেলপার কোনো ব্র্যান্ডের জন্য তার তৈরি করা সকল এজেন্টের একটি তালিকা পেতে পারেন। আরও বিস্তারিত জানতে brands.agents.list দেখুন।

নোড.জেএস 

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);
});

জাভা 

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()));
}

এই কোডটি ব্র্যান্ডের মালিকানাধীন সকল এজেন্টের একটি তালিকা ফেরত দেয়: 

{
  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]
    }
  ]
}

আর্কাইভ করা এজেন্টদের অন্তর্ভুক্ত করুন

ডিফল্টরূপে, সমস্ত এজেন্টের তালিকা থেকে পার্টনার কর্তৃক আর্কাইভ করা এজেন্টদের বাদ দেওয়া হয়। ফলাফলে আর্কাইভ করা এজেন্টদের অন্তর্ভুক্ত করতে, includeArchived প্যারামিটারটি true তে সেট করুন।

নোড.জেএস

`listAgents` মেথডটি আর্কাইভ করা এজেন্টদের অন্তর্ভুক্ত করার জন্য একটি ঐচ্ছিক কনফিগারেশন অবজেক্ট গ্রহণ করে। 
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);
});

জাভা

`listAllAgents` মেথডটিতে দৃশ্যমানতা নিয়ন্ত্রণের জন্য একটি বুলিয়ান প্যারামিটার অন্তর্ভুক্ত রয়েছে। 
// 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()));
}

একজন এজেন্টকে আনলঞ্চ করুন

একটি নির্দিষ্ট অঞ্চল থেকে কোনো এজেন্টকে আনলঞ্চ করতে, updateLaunch মেথডটি কল করুন, কলের `map`-এ টার্গেট অঞ্চলটি নির্দিষ্ট করুন, এবং launchState LAUNCH_STATE_UNLAUNCHED এ সেট করুন। 

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/BRAND_ID/agents/AGENT_ID" \
-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'
      }
    }
  }
}"

একজন এজেন্টকে মুছে ফেলুন

নিরাপত্তাজনিত কারণে, RBM এজেন্টগুলো এখন আর ডিলিট করা যাবে না। সাহায্যের জন্য, RCS for Business সাপোর্ট টিমের সাথে যোগাযোগ করুন ।

আর্কাইভ বা আনআর্কাইভ এজেন্ট

একটি পরিষ্কার এবং সুসংগঠিত কর্মক্ষেত্র বজায় রাখতে, আপনি অব্যবহৃত এজেন্টগুলিকে আর্কাইভ করতে পারেন। কোনো এজেন্টকে আর্কাইভ করলে তা ডিফল্ট এপিআই ডিসকভারি ফলাফল থেকে অদৃশ্য হয়ে যায়।

আর্কাইভ করা শুধুমাত্র দৃশ্যমানতার একটি পরিবর্তন। এটি এজেন্টকে মুছে ফেলে না বা এর অন্তর্নিহিত লঞ্চ অবস্থাকে প্রভাবিত করে না। আপনি যেকোনো সময় একটি এজেন্টকে আনআর্কাইভ করে তার দৃশ্যমানতা পুনরুদ্ধার করতে এবং ব্যবস্থাপনা চালিয়ে যেতে পারেন।

সক্রিয় এজেন্টগুলো যাতে ভুলবশত লুকিয়ে না যায়, তা নিশ্চিত করতে নিম্নলিখিত নিয়মগুলো প্রযোজ্য:

  • যোগ্যতা : আপনি শুধুমাত্র সেই এজেন্টগুলিকে আর্কাইভ করতে পারবেন যেগুলি নিষ্ক্রিয় অবস্থায় আছে: UNLAUNCHED , SUSPENDED , বা REJECTED )।
  • সীমাবদ্ধতা : আপনি কোনো ক্যারিয়ারে চালু LAUNCHED বা PENDING কোনো এজেন্টকে আর্কাইভ করতে পারবেন না। আপনি যদি এই ধরনের কোনো এজেন্টকে আর্কাইভ করার চেষ্টা করেন, তাহলে অনুরোধটি একটি ত্রুটিসহ প্রত্যাখ্যান করা হবে।

আর্কাইভের অবস্থা আপডেট করুন

কোনো এজেন্টকে আর্কাইভ বা আনআর্কাইভ করতে patch মেথডটি ব্যবহার করুন। যে ফিল্ডটি আপডেট করা হচ্ছে তা নির্দিষ্ট করার জন্য আপনাকে অবশ্যই URL-এ updateMask=is_archived প্যারামিটারটি অন্তর্ভুক্ত করতে হবে। আর্কাইভ করার জন্য isArchived বুলিয়ানটিকে true এবং আনআর্কাইভ করার জন্য এটিকে false সেট করুন।

পদ্ধতি : PATCH /v1/brands/{brandId}/agents/{agentId} আপডেট মাস্কে is_archived যোগ করুন। 

{
  "isArchived": true
}

ফিল্টার সহ এজেন্টদের তালিকা

ডিফল্টরূপে, list মেথডটি আর্কাইভ করা এজেন্টদের লুকিয়ে রাখে। আপনার ফলাফলে সেগুলোকে অন্তর্ভুক্ত করতে, include_archived প্যারামিটারটি ব্যবহার করুন।

পদ্ধতি : GET /v1/brands/{brandId}/agents?include_archived=true

পূর্ববর্তী
ব্র্যান্ড পরিচালনা করুন, ব্র্যান্ড পরিচালনা করুন
পরবর্তী
পরীক্ষকদের পরিচালনা করুন