REST Resource: brands.agents

Resource: Agen

Entitas percakapan yang mewakili sebuah 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 diisi. Nama yang ditampilkan agen kepada pengguna. Maksimum 100 karakter.

Tidak dapat diubah setelah verifikasi agen.

Kolom union detail_info. Berisi kolom yang wajib diisi untuk produk tertentu.

Wajib diisi. detail_info hanya dapat berupa salah satu dari yang 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 diisi. Setelan percakapan untuk agen, dipetakan ke suatu lokalitas. Lokalitas diwakili 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 diisi. Lokalitas default untuk agen. Harus cocok dengan lokalitas yang ditentukan di conversationalSettings.
primaryAgentInteraction

object (SupportedAgentInteraction)

Wajib diisi. 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 di 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 diisi. Google platform yang menyediakan agen agar dapat muncul.

EntryPoint

Google platform yang menyediakan agen agar dapat muncul.

Enum
ENTRY_POINT_UNSPECIFIED Titik entri tidak ditentukan.
LOCATION Aktifkan lokasi untuk agen ini.
NON_LOCAL Mengaktifkan 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 diisi. Jenis interaksi yang didukung oleh agen.
Kolom union representative. Info mendetail untuk jenis konfigurasi. Wajib diisi. representative hanya dapat berupa salah satu dari 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 yang tidak ditentukan.
BOT Interaksi bot.
HUMAN Interaksi manusia.

BotRepresentative

Detail untuk perwakilan bot.

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

object (MessagingAvailability)

Wajib diisi. Ketersediaan pesan bot.

MessagingAvailability

Jam setiap hari dalam seminggu saat pesan tersedia. Anda dapat mengelompokkan jam buka untuk beberapa hari sekaligus. 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 celah dalam ketersediaan, seperti tidak ada ketersediaan yang ditentukan pada hari Minggu, fitur pesan tidak tersedia selama jeda 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 diisi. Jam ketersediaan fitur pesan.

Jam

Rentang jam kapan fitur pesan tersedia.

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

object (TimeOfDay)

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

object (TimeOfDay)

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

string

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

enum (DayOfWeek)

Wajib diisi. Hari mulai.
endDay

enum (DayOfWeek)

Wajib diisi. Hari berakhir. Menyertakan hari yang ditentukan.

TimeOfDay

Mewakili waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk memungkinkan 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 waktu tutup bisnis.
minutes

integer

Menit dalam jam. Harus dari 0 hingga 59.
seconds

integer

Detik dalam waktu. Biasanya harus dari 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

integer

Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999.

DayOfWeek

Merepresentasikan hari.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari 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 diisi. Ketersediaan 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 diisi. Informasi kontak untuk agen, yang ditampilkan dengan tombol pesan.
enabledDomains[]

string

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

object (Phone)

Wajib diisi. 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 diisi. Daftar nomor telepon untuk penyimpangan panggilan.
regionCodes[]

string

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

ContactOption

Detail kontak ditampilkan selain tombol pesan.

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

string

Wajib diisi. URL tempat opsi kontak tersedia.
options[]

enum (Option)

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

Opsi

Opsi kontak.

Enum
OPTION_UNSPECIFIED Tidak ditentukan
WEB_CHAT Opsi Web Chat.
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, yang dipetakan ke lokalitas. Lokalitas diwakili 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 diisi. ID unik pertanyaan.
questionType

enum (Type)

Hanya output. Jenis pertanyaan.
questionContent

string

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

object (SurveyResponse)

Wajib diisi. 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 diisi. Teks yang ditampilkan dalam survei dan dikirim kembali ke agen jika 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.