Roboteka
Roboteka · Robôs · Atualizar contato por ID

Atualizar contato por ID

O robô «Atualizar contato por ID» altera qualquer contato pelo seu identificador a partir de qualquer contexto de processo de negócios no Bitrix24 (Alaio). Os campos a alterar são passados como JSON no formato camelCase (name, lastName, assignedById, companyId e outros). Retorna um indicador de sucesso Y/N para a ramificação condicional do processo e funciona através do método universal de CRM crm.item.update.

O robô atualiza um contato arbitrário pelo seu ID, mesmo quando o processo de negócios é executado sobre outra entidade de CRM — um negócio, um lead ou uma tarefa. O ID do contato e o conjunto de campos são informados explicitamente: os campos são passados como uma string JSON no formato camelCase (por exemplo {"name":"John","lastName":"Smith","assignedById":5,"companyId":12}). A atualização usa o método universal crm.item.update, portanto todos os campos do contato ficam disponíveis, inclusive os personalizados. Casos típicos: quando a etapa do negócio muda, atualizar o contato vinculado; definir o responsável e a empresa a partir de dados de um sistema externo; alterar em massa os campos dos contatos a partir de um processo superior. Retorna um indicador Sucesso (Y/N): Y em uma atualização bem-sucedida, N com ID vazio, JSON vazio ou inválido, ou erro de API — compare-o na condição da próxima etapa.

Quais parâmetros de entrada o robô aceita?

Parâmetro Tipo Obrigatório? Padrão
ID do contato int sim
Campos para atualizar (JSON camelCase): {"name":"John","lastName":"Smith","assignedById":5,"companyId":12} string sim

O que o robô retorna?

Parâmetro Tipo
Sucesso (Y/N) string

Cenário: atualização de um contato a partir de um processo sobre um negócio

  1. O negócio passa para uma nova etapa do funil
  2. O robô atualiza o contato vinculado: assignedById e companyId são passados como JSON
  3. Um resultado Y confirma a atualização para a próxima etapa

Robôs semelhantes