Atualiza um Registro - zoho.crm.upsert

A tarefa zoho.crm.upsert insere ou atualiza registros no Zoho CRM. Se o registro existe, ele é atualizado. Se não existe, um novo registro é criado.

Sintaxe

<variable> = zoho.crm.upsert(<module_name>, <records_value>, <duplicate_check_fields>, <options_map>, <connection>);

Parâmetros

• <variable> - Resposta retornada pelo Zoho CRM
• <module_name> - Nome da API do módulo CRM
• <records_value> - Lista de registros a inserir/atualizar
• <duplicate_check_fields> - Campos para verificar duplicidade
• <options_map> - Opções adicionais
• <connection> - Nome da conexão

Exemplo

// Dados do registro
registroMap = {"First_Name":"João","Last_Name":"Silva", "Email":"joao@empresa.com"};

// Upsert - atualiza se existir, cria se não existir
resultado = zoho.crm.upsert("Contacts", registroMap, {"Email"});
info resultado;

Quando Usar

Use zoho.crm.upsert quando:

• Não sabe se o registro já existe
• Quer evitar duplicidade
• Precisa sincronizar dados de sistemas externos

Dica: O campo de verificação de duplicidade (duplicate_check_fields) geralmente é o Email para contatos ou o CNPJ para contas.