> ## Documentation Index
> Fetch the complete documentation index at: https://help.hiredata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adicionar, atualizar ou eliminar registos do Spott a partir de uma automação

> Mantenha o Spott atualizado a partir das suas automações do HireData: adicione notas, atualize ou elimine candidatos e outros registos, e verifique cada alteração antes de ser guardada.

As suas automações já podem escrever no Spott. Registe uma nota depois de uma conversa no WhatsApp, passe uma candidatura para a fase seguinte quando um candidato preenche um formulário, ou mantenha os contactos de um candidato atualizados, sem que ninguém tenha de voltar a escrever tudo no Spott.

## Passo 1: Adicionar um passo do Spott

Na sua automação, clique em **+** e escolha o passo do Spott de que precisa. Existe um passo por ação e objeto do Spott, como **Add Note in Spott**, **Update Candidate in Spott** ou **Delete Note in Spott**.

Em **What do you want to add?** pode mudar para outro objeto do Spott a qualquer momento.

![O passo Add Note in Spott com Note selecionado, os separadores Record e Settings e os campos Title e Content](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/add-note-step.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=6ca341600551dd9696fd4466eeaf7fa9)

## Passo 2: Escolher o registo a alterar

Para atualizar ou eliminar, indique ao HireData que registo do Spott deve alterar:

* **Por ID**, por exemplo o candidato que iniciou a automação.
* **Com condições** que encontram o registo, por exemplo o candidato com um determinado endereço de email.

Depois escolha o que acontece se o registo não for encontrado:

* **Fail the step:** nada muda e o passo falha. É a opção predefinida.
* **Skip the step:** nada muda e a automação continua.
* **Add it instead:** adiciona um novo registo com estes valores.

![O menu If not found com Fail the step, Skip the step e Add it instead](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/if-not-found.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=145311c1ad6ae812b94ea54faf56d719)

Se as suas condições encontrarem mais do que um registo, escolha **Use all**, **Use the first** ou **Fail the step**.

![O menu If several match com Use all, Use the first e Fail the step](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/if-several-match.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=86bbca65e241970d8424f2377990be19)

## Passo 3: Preencher os campos

Escreva um valor ou escolha um campo de um passo anterior da automação, como uma resposta a um formulário. Os campos em que não mexe mostram **Unchanged** e ficam como estão no Spott. Clique em **Change** para definir um novo valor ou limpar o campo.

Nas listas, como os endereços de email de um candidato, pode adicionar um item, substituir a lista inteira ou remover os itens correspondentes.

O HireData trata de algumas coisas por si:

* **As respostas são associadas às opções do Spott** por nome ou valor, para que uma resposta de formulário como "sim" ou o nome de uma fase fique na opção certa.
* **Números e datas** são lidos tal como o seu workspace os escreve.
* **Novas candidaturas e vagas** podem ser colocadas num track específico do pipeline, e uma candidatura numa subfase.
* **Um valor que não pode ser lido** para o passo e mostra qual era, em vez de esvaziar o campo no Spott.

![Os campos de um passo Update Candidate: First name preenchido, os outros campos marcados como Unchanged com um botão Change](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/update-fields.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=22dee95ae92fa1936e5df9daf2c137a1)

> [!TIP]
>
> Uma atualização só altera os campos que definir. Se nada mudasse, o passo é ignorado em vez de guardar os mesmos valores, e a execução explica porquê.

## Passo 4: Pré-visualizar antes de guardar

Clique em **Preview**, procure um registo de exemplo pelo nome e clique em **Run preview**. Vê exatamente o que seria adicionado ou alterado. Nada é guardado no Spott.

![A janela Preview: um candidato de exemplo à esquerda e, à direita, a nota que seria adicionada com título e conteúdo](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/write-preview.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=c83520d38836cca6841698020118f4de)

## Passo 5: Verificar o que foi guardado

Abra uma execução e clique no passo do Spott. Vê que registo foi alterado, cada campo alterado com o valor antigo e o novo, e **Open in Spott** para ir diretamente ao registo.

Se algo correr mal, a execução explica-o em linguagem simples, como **Record not found**.

![Um passo Update Candidate in Spott concluído com o candidato, um botão Open in Spott e o endereço de email adicionado em Changes](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/write-run-result.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=f376f5deac48509ae66224b87bfc5c40)

## O que ainda não é possível

* **As vagas** não podem ser eliminadas, porque o Spott não o permite.
* **As colocações** podem ser atualizadas, mas não adicionadas nem eliminadas.

## Artigos relacionados

* [Criar uma automação do Spott](https://help.hiredata.com/pt/apps/spott/create-a-spott-automation-in-hiredata.md)
* [Testar uma automação](https://help.hiredata.com/pt/automations/how-to-test-an-automation.md)


## Related topics

- [Alterar registos do Carerix a partir de uma automação](https://help.hiredata.com/pt/beta/carerix-records.md)
- [Visão geral da integração com o Spott](https://help.hiredata.com/pt/apps/spott/overview.md)
- [Criar uma automação do Spott](https://help.hiredata.com/pt/apps/spott/create-a-spott-automation-in-hiredata.md)
- [Gerir pessoas HireData a partir de uma automação](https://help.hiredata.com/pt/beta/hiredata-people.md)
- [Iniciar automações a partir de mais registos do Carerix](https://help.hiredata.com/pt/beta/carerix-triggers.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.