Genesys Cloud - Main

Dear colleagues,

I would like to use some custom contact types for our External Contacts. I created some Custom Fields and I can use them for already created contacts. My goal however is to add this data in the process of Bulk Import. I tried to find the proper information and made some tests, but I don`t have any success.

Could anybody help me about this topic?

Best regards,

Borislav

#Unsure/Other

------------------------------
Borislav Taskov
------------------------------

Hi Borislav Taskov, 

Maybe check if your import file includes the full schema, including the custom fields structure. Sometimes the import won't work if the schema isn't exactly the same as the one defined in Genesys Cloud.

Hope this helps

------------------------------
Luiz Rosa
Full stack developer
------------------------------

Olá @Borislav Taskov,

Você está no caminho certo. Os Campos Personalizados (Custom Fields) dos External Contacts podem ser usados normalmente depois que o contato já existe, porém é importante destacar que o Bulk Import não suporta importar esses campos diretamente. O importador em CSV aceita apenas os atributos padrão (nome, telefone, e-mail, endereço, organização etc.).

Para incluir dados nos campos personalizados durante uma carga em massa, o processo recomendado é feito em duas etapas:

1) Importar os contatos normalmente (sem os campos customizados)

No Genesys Cloud:
Admin → Directory → External Contacts → Bulk Import

Isso criará todos os contatos com os dados básicos.

2) Atualizar os Campos Personalizados via API (processamento em lote)

Depois que os contatos existirem e você tiver o contactId, aplique os valores dos campos personalizados usando:

PATCH /api/v2/externalcontacts/contacts/{contactId}

Exemplo de corpo:

{
  "customFields": {
    "nomeDoCampoCustomizado": "valor_a_definir",
    "outroCampoCustomizado": "outro_valor"
  }
}

Se forem muitos contatos:

1. Faça a importação básica

2. Exporte os contatos para obter os contactId

3. Una o CSV com os valores dos campos personalizados

4. Rode um script para aplicar o PATCH em lote

Atualmente, o CSV de importação não possui colunas para Custom Fields.
Somente as APIs permitem definir ou atualizar esses campos.

Ou seja, o fluxo correto é:

Importar Contato → Obter ID → Atualizar Campos Customizados via API.

------------------------------
Fernando Sotto dos Santos
Consultor Grupo Casas Bahia
------------------------------