1. Use as funções personalizadas para mover cartões automaticamente para os estágios anteriores ou posteriores, quando transições específicas ou atualizações de cartões forem realizadas.
   
2. Você também pode postar comentários, mensagens ou atualizações em outros aplicativos usados em sua organização, como Zoho Desk, Zoho Cliq ou MS Teams, usando funções personalizadas. 
   

Autenticação de API para chamar funções personalizadas

1. OAuth 2.0
   
2. Chave de API
   

Melhores práticas

1. Não compartilhe a chave de API com usuários não autorizados ou externos, pois qualquer usuário com acesso à chave de API pode executar todas as operações. 
   
2. Recomendamos que você gere novamente a chave de API periodicamente para garantir a segurança. 
   

Cenários de negócios  

• Atualize o site da sua empresa dinamicamente com o número de vagas abertas quando um candidato for selecionado no processo de recrutamento.
  

• Calcule o tempo total gasto por um usuário em cada etapa e envie um resumo detalhado por e-mail ao cliente para cobrança.
  

• Integre o Qntrl a um aplicativo de calendário e envie convites de entrevista para os candidatos pré-selecionados.
  

• Integre o Qntrl ao  Jira para adicionar um cartão ao Qntrl para cada projeto criado no Jira. 
  

Criar uma função personalizada baseada em cartão

1. Navegue até   e selecione Custom Functions (Funções personalizadas) em Advanced (Avançado) no menu.
   

2. Clique em  New Custom Function (Nova função personalizada).
   

3. Preencha os dados:
   

• Module Type (Tipo de módulo) :   selecione  Cards (Cartões)  se a função exigir argumentos de cartão. 
  

• Function Name  (Nome da função) : nomeie sua função.
  

• Return Type  (Tipo de retorno) :   o tipo de retorno para funções personalizadas baseadas em cartão sempre será nulo . 
  

• Description (Descrição)  : descreva como a função funciona.
  

• Arguments (Argumentos)  : digite os argumentos usados no trecho de código. Você pode usar o valor personalizado ou escolher um campo de formulário na lista suspensa. Os campos de formulário capturam valores dinâmicos de campos de cartão correspondentes à função personalizada.   

• Connections (Conexões)  : configure as integrações internas ou de terceiros aqui. Saiba mais sobre as conexões.
  

• Codifique sua função personalizada. 
  

4. Clique em  Save (Salvar) ou  Save & Execute (Salvar e executar).    
   

1. As funções personalizadas baseadas em cartão só podem ser chamadas usando o protocolo OAuth 2.0.
   
2. Somente as funções personalizadas baseadas em cartão podem ser chamadas a partir de blueprints e regras de negócios. 
   
3. O Module type (Tipo de módulo), uma vez selecionado, não pode ser editado.  
   
4. Os argumentos para campos suspensos podem ser passados usando o ID de campo obtido via API.

Criar uma função personalizada independente 

1. Navegue até    e  selecione  Custom Functions (Funções personalizadas)  em  Advanced (Avançado)   no menu.   
   

2. Clique em  New Custom Function (Nova função personalizada).
   

3. Preencha os dados:
   

• Module Type (Tipo de módulo)  : selecione  Standalone (Independente) se a função exigir apenas argumentos independentes. 
  

• Function Name (Nome da função)  : nomeie sua função. 
  

• Return Type (Tipo de retorno)  : selecione um tipo de retorno para a função personalizada. 
  

• Description (Descrição)  : descreva como a função funciona.
  

• Arguments (Argumentos)  : digite os argumentos usados no trecho de código. 
  

• Connections (Conexões)  : configure as integrações internas ou de terceiros aqui.  Saiba mais  sobre conexões.
  

• Codifique sua função personalizada. 
  

4. Clique em  Save (Salvar)  ou  Save & Execute (Salvar e executar).    
   

1. As funções personalizadas autônomas podem ser chamadas usando o protocolo OAuth 2.0 ou a chave de API. 
   
2. O Module Type (Tipo de módulo), uma vez selecionado, não pode ser editado.  
   

Chamar funções autônomas usando a chave de API  

1. Passe o mouse sobre a função personalizada e clique em .
   
2. Selecione  REST   API (REST API)no menu suspenso.
   
3. Alterne o botão ao lado da chave de API para ativá-la.
   

Agendar funções personalizadas

As funções personalizadas que estão sendo usadas em Schedules (Agendas) não podem ser excluídas. 

Associar função personalizada a blueprints 

As funções personalizadas podem ser configuradas para serem acionadas após uma transição ocorrer em um blueprint. Saiba mais sobre blueprints.

1. Navegue até     e selecione  Orchestration (Orquestração) no menu.
   

2. Selecione uma orquestração existente ou crie uma nova. Saiba mais sobre orquestração. 
   
1. Você entrará na Etapa 1: Criar Formulário.
   
3. Navegue até a  Etapa 2: Projetar Blueprint . 
   

4. Clique em uma transição e navegue até a seção  After (Após) no painel direito.
   

5. Agora, em   Instant Actions (Ações instantâneas)  ou  Schedule Actions (Ações agendadas)  , clique no ícone    ao lado de  Associate Custom Functions (Associar funções personalizadas) . 
   

6. Selecione uma função na  Function Gallery (Galeria de funções) ou  Configured Functions (Funções configuradas).
   

• Ao associar uma função da galeria, clique em  Save as New (Salvar como novo). 
  

• Ao associar uma função configurada, clique em  Save (Salvar)  ou  Save & Execute (Salvar e executar) .  
  

7. Depois que as funções estiverem configuradas,  Salve   o blueprint.  
   

Um máximo de três funções personalizadas pode ser associado a cada transição de blueprint.  

Associar função personalizada a regras de negócios

As regras de negócios são configuradas para serem acionadas quando um cartão é criado ou atualizado ou quando um campo é atualizado. Saiba mais  sobre as regras de negócio aqui. As regras de negócios podem, por sua vez, acionar as funções personalizadas associadas a elas. 

1. Navegue até     e selecione  Business Rules (Regras de negócio) em  Automation (Automação) no menu. 
   

2. Crie uma nova regra de negócios ou abra uma regra existente.  Saiba mais sobre as  regras de negócio.
   
3. Preencha os detalhes da regra e passe para   Criteria & Actions (Critérios e ações).
   
4. Agora  ,   clique no    icone ao lado de   Instant Actions (Ações instantâneas)  ou  Schedule Actions (Ações agendadas)  e selecione  Custom Functions (Funções personalizadas)    na lista suspensa.
   

5. Selecione uma função na  Function Gallery (Galeria de funções) ou  Configured Functions (Funções configuradas). 
   

• Ao associar uma função da galeria, clique em  Save as New (Salvar como novo). 
  

• Ao associar uma função configurada, clique em  Save (Salvar)  ou  Save & Execute (Salvar e executar) .  
  

6. Depois de configurar as funções, clique em  Save (Salvar) .  
   

No máximo três funções personalizadas podem ser associadas a cada regra de negócios.

Priorizar a função personalizada 

1. Navegue até a função personalizada associada no Blueprint/Regra de negócios e passe o mouse sobre ela.
   
2. Clique em mais opções e marque Prioritize this function’s execution (Priorizar a execução desta função) .
   

 

Observação: 

1. As funções personalizadas configuradas em Schedule Actions (Ações agendadas) não podem ser priorizadas.
   
2. Somente uma função personalizada por bloco de ação instantânea pode ser priorizada.