Genesys Cloud - Main

 View Only

Sign Up

  • 1.  External Contacts Bulk Import

    Posted 16 days ago

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


  • 2.  RE: External Contacts Bulk Import
    Best Answer

    Posted 16 days ago
    Edited by Jason Kleitz 9 days ago

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

    Original Message


  • 3.  RE: External Contacts Bulk Import

    Posted 14 days ago

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

    Original Message


Related Content