REST Resource: brands.agents

Resource: Agen

Entitas percakapan yang mewakili brand.

Representasi JSON 
{
  "name": string,
  "displayName": string,

  // Union field detail_info can be only one of the following:
  "businessMessagesAgent": {
    object (BusinessMessagesAgent)
  }
  // End of list of possible types for union field detail_info.
}
Kolom
name

string

ID unik agen.

Hanya baca. Ditentukan oleh platform.
displayName

string

Wajib. Nama yang ditampilkan agen kepada pengguna. Maksimum 100 karakter.

Tidak dapat diubah setelah verifikasi agen.

Kolom union detail_info. Berisi kolom yang diperlukan untuk produk tertentu.

Wajib. detail_info hanya dapat berupa salah satu dari berikut:
businessMessagesAgent

object (BusinessMessagesAgent)

Informasi agen mendetail untuk Business Messages.

BusinessMessagesAgent

Informasi agen khusus untuk Business Messages.

Representasi JSON 
{
  "logoUrl": string,
  "entryPointConfigs": [
    {
      object (BusinessMessagesEntryPointConfig)
    }
  ],
  "conversationalSettings": {
    string: {
      object (ConversationalSetting)
    },
    ...
  },
  "defaultLocale": string,
  "primaryAgentInteraction": {
    object (SupportedAgentInteraction)
  },
  "additionalAgentInteractions": [
    {
      object (SupportedAgentInteraction)
    }
  ],
  "customAgentId": string,
  "agentTestUrl": string,
  "testUrls": [
    {
      object (TestUrl)
    }
  ],
  "phone": {
    object (Phone)
  },
  "authorizationConfig": {
    object (AuthorizationConfig)
  },
  "nonLocalConfig": {
    object (NonLocalConfig)
  },
  "surveyConfig": {
    object (SurveyConfig)
  }
}
Kolom
logoUrl

string

Opsional. URL logo yang tersedia secara publik untuk agen. Maksimum 50 KB.

Tidak dapat diubah setelah verifikasi agen.
entryPointConfigs[]

object (BusinessMessagesEntryPointConfig)

Opsional. Daftar konfigurasi titik entri.

Tidak dapat diubah setelah verifikasi agen.
conversationalSettings

map (key: string, value: object (ConversationalSetting))

Wajib. Setelan percakapan untuk agen, dipetakan ke lokal. Lokalitas direpresentasikan oleh tag bahasa IETF BCP 47 yang diformat dengan baik.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultLocale

string

Wajib. Lokalitas default untuk agen. Harus cocok dengan lokalitas yang ditentukan di conversationalSettings.
primaryAgentInteraction

object (SupportedAgentInteraction)

Wajib. Informasi interaksi agen utama. Digunakan saat pengguna memulai percakapan.
additionalAgentInteractions[]

object (SupportedAgentInteraction)

Opsional. Informasi interaksi agen tambahan. Memungkinkan agen mendukung beberapa jenis interaksi.
customAgentId

string

Opsional. ID yang ditentukan partner untuk agen. ID diteruskan bersama semua pesan yang dikirim ke agen.
agentTestUrl
(deprecated)

string

Hanya output. URL untuk menguji pengalaman percakapan agen.

Ditentukan oleh platform.
testUrls[]

object (TestUrl)

Hanya output. URL untuk menguji pengalaman percakapan agen.

Ditentukan oleh platform.
phone

object (Phone)

Opsional. Nomor telepon yang akan ditampilkan oleh agen. Jika tidak ditentukan, agen akan menampilkan nomor telepon untuk merek yang ditemukan dalam Pustaka Pengetahuan Google, jika ada.
authorizationConfig

object (AuthorizationConfig)

Opsional. Konfigurasi otorisasi untuk dukungan OAuth.
nonLocalConfig

object (NonLocalConfig)

Opsional. Konfigurasi untuk titik entri non-lokal.
surveyConfig

object (SurveyConfig)

Opsional. Konfigurasi untuk mengaktifkan survei kustom.

BusinessMessagesEntryPointConfig

Konfigurasi titik entri untuk agen.

Representasi JSON 
{
  "allowedEntryPoint": enum (EntryPoint)
}
Kolom
allowedEntryPoint

enum (EntryPoint)

Wajib. Google memunculkan agen tempat agen dapat ditampilkan.

EntryPoint

Google memunculkan agen tempat agen dapat ditampilkan.

Enum
ENTRY_POINT_UNSPECIFIED Titik entri tidak ditentukan.
LOCATION Aktifkan lokasi untuk agen ini.
NON_LOCAL Aktifkan Business Messages untuk titik entri non-lokal.

SupportedAgentInteraction

Interaksi yang didukung oleh agen.

Representasi JSON 
{
  "interactionType": enum (InteractionType),

  // Union field representative can be only one of the following:
  "botRepresentative": {
    object (BotRepresentative)
  },
  "humanRepresentative": {
    object (HumanRepresentative)
  }
  // End of list of possible types for union field representative.
}
Kolom
interactionType

enum (InteractionType)

Wajib. Jenis interaksi yang didukung oleh agen.
Kolom union representative. Info terperinci untuk jenis konfigurasi. Wajib. representative hanya ada berupa salah satu diantara berikut:
botRepresentative

object (BotRepresentative)

Detail perwakilan bot.
humanRepresentative

object (HumanRepresentative)

Detail perwakilan manusia.

InteractionType

Jenis interaksi yang didukung untuk agen.

Enum
INTERACTION_TYPE_UNSPECIFIED Interaksi tidak ditentukan.
BOT Interaksi bot.
HUMAN Interaksi manusia.

BotRepresentative

Detail untuk perwakilan bot.

Representasi JSON 
{
  "botMessagingAvailability": {
    object (MessagingAvailability)
  }
}
Kolom
botMessagingAvailability

object (MessagingAvailability)

Wajib. Ketersediaan fitur pesan bot.

MessagingAvailability

Jam tersedianya fitur pesan. Anda dapat mengelompokkan jam buka selama beberapa hari. Misalnya, * 08.00–16.00 PDT Senin–Rabu * 10.00–14.00 PDT Kamis–Jumat * 15.00–18.00 PDT Kamis–Jumat * 10.00–14.00 PDT Sabtu–Sabtu

Jika ada kesenjangan ketersediaan, seperti tidak ada ketersediaan yang ditentukan pada hari Minggu, pesan tidak akan tersedia selama selisih tersebut.

Jam bot tidak berpengaruh pada ketersediaan. Agen khusus bot selalu menampilkan pesan selamat datang, sedangkan agen dengan setelan perwakilan manusia dan bot hanya mempertimbangkan perwakilan manusia saat menentukan ketersediaan.

Representasi JSON 
{
  "hours": [
    {
      object (Hours)
    }
  ]
}
Kolom
hours[]

object (Hours)

Wajib. Jam ketersediaan fitur pesan.

Jam

Rentang jam saat fitur pesan tersedia.

Representasi JSON 
{
  "startTime": {
    object (TimeOfDay)
  },
  "endTime": {
    object (TimeOfDay)
  },
  "timeZone": string,
  "startDay": enum (DayOfWeek),
  "endDay": enum (DayOfWeek)
}
Kolom
startTime

object (TimeOfDay)

Wajib. Waktu mulai untuk setiap hari dalam rentang hari.
endTime

object (TimeOfDay)

Wajib. Waktu berakhir untuk setiap hari dalam rentang hari.
timeZone

string

Wajib. Zona waktu IANA untuk jam. Misalnya, "Amerika/Los_Angeles".
startDay

enum (DayOfWeek)

Wajib. Hari mulai.
endDay

enum (DayOfWeek)

Wajib. Hari akhir. Menyertakan hari yang ditentukan.

TimeOfDay

Mewakili waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk mengizinkan detik kabisat. Jenis terkait adalah google.type.Date dan google.protobuf.Timestamp.

Representasi JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Kolom
hours

integer

Jam dalam format 24 jam. Harus dari 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti jam tutup bisnis.
minutes

integer

Menit dalam jam. Harus dari 0 hingga 59.
seconds

integer

Detik menit dari waktu. Biasanya harus antara 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan kabisat-detik.
nanos

integer

Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999.

DayOfWeek

Merepresentasikan hari dalam seminggu.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari dalam seminggu tidak ditentukan.
MONDAY Senin
TUESDAY Selasa
WEDNESDAY Rabu
THURSDAY Kamis
FRIDAY Jumat
SATURDAY Sabtu
SUNDAY Minggu

HumanRepresentative

Detail untuk perwakilan manusia.

Representasi JSON 
{
  "humanMessagingAvailability": {
    object (MessagingAvailability)
  }
}
Kolom
humanMessagingAvailability

object (MessagingAvailability)

Wajib. Ketersediaan fitur pesan manusia.

AuthorizationConfig

Detail konfigurasi untuk mendukung OAuth di Business Messages.

Representasi JSON 
{
  "endpointUrl": string
}
Kolom
endpointUrl

string

URL endpoint tempat pengguna login.

NonLocalConfig

Konfigurasi untuk mengaktifkan titik entri non-lokal.

Representasi JSON 
{
  "contactOption": {
    object (ContactOption)
  },
  "enabledDomains": [
    string
  ],
  "phoneNumber": {
    object (Phone)
  },
  "callDeflectionPhoneNumbers": [
    {
      object (Phone)
    }
  ],
  "regionCodes": [
    string
  ]
}
Kolom
contactOption

object (ContactOption)

Wajib. Informasi kontak untuk agen, yang ditampilkan dengan tombol pesan.
enabledDomains[]

string

Wajib. Domain yang akan diaktifkan untuk titik entri sitelink.
phoneNumber

object (Phone)

Wajib. Nomor telepon agen. Mengganti kolom phone untuk percakapan yang dimulai dari titik entri non-lokal. Nomor telepon ini akan digunakan untuk semua wilayah yang dikonfigurasi.
callDeflectionPhoneNumbers[]

object (Phone)

Wajib. Daftar nomor telepon untuk pengalihan panggilan.
regionCodes[]

string

Wajib. Daftar kode wilayah CLDR untuk negara tempat agen diizinkan untuk meluncurkan titik entri NON_LOCAL. Diperlukan untuk titik entri NON_LOCAL.

ContactOption

Detail kontak ditampilkan selain tombol pesan.

Representasi JSON 
{
  "url": string,
  "options": [
    enum (Option)
  ]
}
Kolom
url

string

Wajib. URL yang menyediakan opsi kontak.
options[]

enum (Option)

Wajib. Daftar opsi kontak yang tersedia untuk URL yang ditentukan.

Opsi

Opsi kontak.

Enum
OPTION_UNSPECIFIED Belum ditetapkan
WEB_CHAT Opsi Chat Web.
PHONE Opsi telepon.
EMAIL Opsi email.
FAQS opsi FAQ.
TWITTER Opsi Twitter.
WHATSAPP Opsi WhatsApp.

SurveyConfig

Detail konfigurasi untuk mendukung pertanyaan survei yang disesuaikan.

Representasi JSON 
{
  "templateQuestionIds": [
    string
  ],
  "customSurveys": {
    string: {
      object (CustomSurveyConfig)
    },
    ...
  }
}
Kolom
templateQuestionIds[]

string

Daftar ID pertanyaan template untuk pertanyaan template yang disertakan dalam survei.
customSurveys

map (key: string, value: object (CustomSurveyConfig))

Pertanyaan survei kustom untuk agen, dipetakan ke lokalitas. Lokalitas direpresentasikan oleh tag bahasa IETF BCP 47 yang diformat dengan baik.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CustomSurveyConfig

Konfigurasi survei kustom untuk agen.

Representasi JSON 
{
  "customQuestions": [
    {
      object (SurveyQuestion)
    }
  ]
}
Kolom
customQuestions[]

object (SurveyQuestion)

Daftar pertanyaan kustom.

SurveyQuestion

Konten terperinci dari setiap pertanyaan survei.

Representasi JSON 
{
  "name": string,
  "questionType": enum (Type),
  "questionContent": string,
  "responseOptions": [
    {
      object (SurveyResponse)
    }
  ]
}
Kolom
name

string

Wajib. ID unik pertanyaan.
questionType

enum (Type)

Hanya output. Jenis pertanyaan.
questionContent

string

Wajib. Konten pertanyaan. Dibatasi hingga 200 karakter untuk pertanyaan kustom.
responseOptions[]

object (SurveyResponse)

Wajib. Daftar respons yang ditampilkan bersama pertanyaan. Maksimum 12.

Jenis

Jenis pertanyaan survei.

Enum
TYPE_UNSPECIFIED Jenis pertanyaan survei tidak diketahui.
GOOGLE_STANDARD_QUESTION Pertanyaan survei standar Google.
GOOGLE_TEMPLATE_QUESTION Template pertanyaan survei yang disediakan Google.
PARTNER_CUSTOM_QUESTION Pertanyaan survei yang disesuaikan partner.

SurveyResponse

Konten untuk respons pertanyaan survei.

Representasi JSON 
{
  "content": string,
  "postbackData": string
}
Kolom
content

string

Wajib. Teks yang ditampilkan di survei dan dikirim kembali ke agen saat pengguna mengetuknya. Maksimum 35 karakter.
postbackData

string

String yang diterima agen saat pengguna mengetuk respons pertanyaan.

Metode

create

 Membuat agen baru untuk mewakili brand.

delete

 Menghapus agen.

get

 Mendapatkan informasi tentang agen.

getLaunch

 Mendapatkan informasi peluncuran untuk agen.

getVerification

 Mendapatkan informasi verifikasi untuk agen.

list

 Mencantumkan semua agen yang terkait dengan merek.

patch

 Memperbarui informasi tentang agen.

requestLaunch

 Memulai proses peluncuran untuk agen.

requestVerification

 Memulai verifikasi informasi bisnis untuk agen.

updateLaunch

 Memperbarui informasi peluncuran untuk agen.

updateVerification

 Memperbarui status verifikasi untuk agen.