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

> Saiba que campos e chaves do Carerix estão disponíveis na HireData, onde inspecionar o payload de uma ligação ou de um evento e como resolver dados em falta.

# Campos do webhook do Carerix

*Quando o Carerix envia um evento para a HireData, o evento contém os campos ativados para o objeto relevante na sua ligação Carerix. Este guia explica que campos de candidato estão habitualmente disponíveis, onde encontrar as suas chaves e como confirmar exatamente o que a HireData recebeu para um registo específico.*

## Como os campos do Carerix chegam à HireData

Cada ligação Carerix tem o seu próprio conjunto de campos ativados. Isto significa que os campos disponíveis numa conta HireData podem diferir dos de outra conta, mesmo quando ambas usam o mesmo objeto do Carerix.

A **Object Definition** da ligação determina que campos ficam disponíveis para novos eventos e automações. O separador **Data** de um evento real mostra depois os valores que a HireData recebeu para um registo específico.

<Note>
  Use a tabela de campos abaixo como guia para os campos comuns de Candidate. As definições da sua ligação e o separador **Data** do evento são a fonte de verdade para os campos disponíveis na sua conta.
</Note>

## Campos de Candidate num relance

O objeto Candidate padrão inclui habitualmente os seguintes campos:

| Campo                  | Chave                      | Utilização típica                                          |
| ---------------------- | -------------------------- | ---------------------------------------------------------- |
| Id                     | `{{_id}}`                  | Identificar o registo do Carerix                           |
| First Name             | `{{firstName}}`            | Personalizar mensagens e atualizações                      |
| Last Name              | `{{lastName}}`             | Personalizar mensagens e atualizações                      |
| Email Address          | `{{emailAddress}}`         | Usar o campo de email principal                            |
| Business Email Address | `{{businessEmailAddress}}` | Usar o campo de email profissional                         |
| Private Email Address  | `{{privateEmailAddress}}`  | Usar o campo de email privado                              |
| Primary Email Address  | `{{primaryEmailAddress}}`  | Usar o campo de email primário do Carerix                  |
| Any Email Address      | `{{anyEmailAddress}}`      | Selecionar um email usando a ordem de fallback da HireData |

Quando uma automação só precisa de um endereço de email utilizável, **Any Email Address** pode ser mais fiável do que selecionar um campo de email específico. Consulte [Campos combinados: como a HireData escolhe um valor](/pt/apps/carerix/combined-fields-explained) para a ordem de fallback completa.

## Confirmar os campos na sua ligação

Verifique a ligação Carerix quando precisar de saber se um campo está ativado ou que chave a HireData usa para ele.

1. Vá a **Settings** > **Apps**.
2. Abra **Carerix**.
3. Abra o menu de três pontos da ligação relevante e selecione **Edit**.
4. Selecione um objeto, como **Candidate**, **Contact**, **Meeting** ou **User**.
5. Reveja a tabela **Object Definition**.

A tabela mostra a **Label**, o **Type** e a **Key** de cada campo. Apenas os campos ativados ficam disponíveis para novos eventos desse objeto.

Se o campo de que precisa estiver desativado, consulte [Ativar campos e relações do Carerix](/pt/apps/carerix/how-to-enable-carerix-fields-and-relationships-in-your-automations) antes de alterar a ligação.

## Inspecionar o payload exato do evento

Use um evento real quando precisar de confirmar que campos e valores a HireData recebeu para um registo individual.

1. Selecione **Events** na navegação principal.
2. Encontre e abra o evento do Carerix relevante.
3. Selecione o separador **Data**.
4. Use a vista de tabela ou de árvore disponível para explorar os campos.
5. Selecione a vista de código (`</>`) quando precisar de inspecionar o JSON em bruto ou confirmar uma chave e um valor exatos.

O separador **Runs** do evento mostra que automações o processaram. Isto é útil quando o payload contém o campo esperado mas uma automação não se comportou como pretendido.

Para uma explicação mais completa da vista de detalhe do evento, consulte [Events](/pt/settings/logs/events).

## Escolher o trigger do Carerix adequado

Quando configura um bloco **Start** do Carerix, o seletor de triggers pode incluir:

* **Created**
* **Created or Updated**
* **Updated**
* **Schedule**
* **Manual**

Escolha o trigger que corresponde ao momento em que a automação deve começar. Por exemplo, use **Created or Updated** quando a mesma automação deve tratar tanto registos novos como alterações posteriores.

**Deleted** não é atualmente oferecido no seletor de triggers.

## Resolver problemas de um campo em falta

Se um campo existe no Carerix mas não aparece na HireData:

1. Confirme que está a verificar o objeto do Carerix correto.
2. Abra a **Object Definition** da ligação e confirme que o campo está ativado.
3. Se o campo foi criado ou alterado recentemente no Carerix, execute uma [sincronização manual](/pt/apps/carerix/manually-sync-carerix-with-hiredata).
4. Crie ou atualize um registo de teste para gerar um novo evento.
5. Inspecione o separador **Data** e a vista de código do novo evento.

Ativar um campo não o adiciona a eventos que a HireData recebeu anteriormente. Use um evento gerado de novo quando testar uma alteração à ligação.

## Precisa de mais ajuda?

Se o campo estiver ativado mas continuar em falta nos novos eventos, contacte [support@hiredata.com](mailto:support@hiredata.com). Inclua:

* A ligação Carerix e o nome do objeto
* A label e a chave do campo
* Um link ou o ID de um evento recente
* O resultado que esperava


## Related topics

- [Como ativar campos e relações do Carerix nas suas automações](/pt/apps/carerix/how-to-enable-carerix-fields-and-relationships-in-your-automations.md)
- [Visão geral da integração com Carerix](/pt/apps/carerix/overview.md)
- [Adicionar uma atividade ou item no Carerix com a HireData](/pt/apps/carerix/add-an-activity-or-item-in-carerix-with-hiredata.md)
- [Adicionar uma atividade ou item no Vincere com a HireData](/pt/apps/vincere/add-an-activity-or-item-in-vincere-with-hiredata.md)
- [Como usar formulários em conversas de WhatsApp](/pt/apps/messaging/whatsapp/how-to-use-forms-in-whatsapp-conversations.md)