> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Person Accounts
> O que muda quando sua organização usa Person Accounts: por que o tipo de registro é obrigatório ao criar, como o nome e o sobrenome são escritos e como ramificar um fluxo de acordo com o tipo de conta.
**Person Accounts** é uma funcionalidade do Salesforce que combina em um único registro os campos de uma Conta (`Account`) e os de um Contato (`Contact`), para representar uma pessoa física em vez de uma empresa.
Se sua organização tem essa funcionalidade ativada, um mesmo objeto `Account` pode conter **duas coisas diferentes**: empresas (*Business Accounts*) e pessoas (*Person Accounts*). O que as separa é o **tipo de registro**.
**Essa distinção é a origem de quase todos os problemas.** O Treble consegue escrever perfeitamente em uma Person Account, mas uma conta se torna Person Account **no momento em que é criada**, e isso não pode ser alterado depois com um bloco.
## Antes de começar: a configuração no Salesforce
Person Accounts exige uma preparação do lado do Salesforce que é independente do Treble. Se ela estiver incompleta, o Treble não vai conseguir criar Person Accounts por mais bem configurado que esteja.
Peça ao seu administrador do Salesforce que confirme, **para o perfil do usuário com o qual o Treble foi conectado**:
Em *Setup → Profiles →* o perfil *→ Record Type Settings → Accounts*, o tipo de registro de Person Account deve estar em **Selected Record Types**.
Na seção *Business Account and Person Account Default Record Types*, o menu suspenso **Person Account Default Record Type** deve ter o tipo de Person Account selecionado.
O menu suspenso **Business Account Default Record Type** deve ter um valor real, não `--Master--`.
Lembre-se da recomendação geral: conecte o Treble com um **usuário de serviço** dedicado. Se o usuário for o de uma pessoa da equipe e alguém alterar o perfil dela, a integração pode começar a criar Business Accounts sem que ninguém perceba.
## Como garantir que o Treble crie Person Accounts
**Definir `RecordTypeId` em um bloco de ação não é suficiente.** Os blocos escrevem **depois** que o registro existe: quando o bloco tenta definir o tipo, a conta já foi criada como Business Account, ou a criação já falhou por causa de uma regra de validação.
Por que isso acontece
Há duas formas de fazer a conta nascer corretamente:
É a configuração do Salesforce que você acabou de revisar. Se o perfil do usuário da integração tiver o tipo de Person Account como seu tipo padrão, as contas que o Treble criar nascem como Person Accounts, sem configuração adicional.
É a solução mais robusta porque não depende de nenhum fluxo nem de nenhum bloco.
O Treble pode enviar um `RecordTypeId` fixo **no momento da criação** de qualquer `Account`.
Escreva para o seu Customer Success Manager com o **Id de 18 caracteres** do tipo de registro de Person Account. Você o encontra em *Setup → Object Manager → Account → Record Types*, abrindo o tipo e copiando o Id da URL.
É um valor fixo para **todo** o objeto `Account`. Se sua operação também precisa criar empresas (Business Accounts) a partir do Treble, esta opção não serve: todas as contas ficariam como Person Accounts. Comente isso com o seu Customer Success Manager antes de solicitar.
## Nome e sobrenome
Em uma Person Account, o nome funciona de forma diferente de uma conta de empresa:
| Campo | Em uma Business Account | Em uma Person Account |
| - | - | - |
| `Name` | É o nome da empresa, e é escrito diretamente | **Não pode ser escrito.** O Salesforce o monta sozinho, juntando o nome e o sobrenome |
| `FirstName` | Não se aplica | O nome da pessoa |
| `LastName` | Não se aplica | O sobrenome. O Salesforce o exige |
Você pode escrever `FirstName` e `LastName` a partir de um bloco de ação, como qualquer outra propriedade. O campo `Name` aparecerá atualizado sozinho, a partir dos dois.
Se você tentar escrever diretamente em `Name` em uma Person Account, o Salesforce rejeita. Use `FirstName` e `LastName`.
`LastName` é obrigatório no Salesforce para uma Person Account. Se o seu fluxo pergunta apenas o nome, considere pedir também o sobrenome, ou definir um valor de reserva com o seu Customer Success Manager para que a criação não falhe quando a pessoa não o informar.
## Ramificar o fluxo de acordo com o tipo de conta
Quando o seu objeto `Account` tem pessoas e empresas misturadas, muitas vezes você quer tratá-las de forma diferente na conversa.
O padrão é ler o tipo de registro em uma variável e conectar um bloco de **Condições**:
Com o [bloco de leitura](/pt/docs/integrations/salesforce/blocks/crm-variable-assignment), sobre o objeto `Account`, salve o valor em uma variável como `{{record_type}}`.
Crie uma condição para *Person Account* e outra para *Business Account*, e deixe o caso padrão para todo o resto (por exemplo, quando a pessoa ainda não existe e a variável chega vazia).
Não se esqueça do caminho *Em todos os outros casos*. Para um contato novo que ainda não existe no Salesforce, a variável chega vazia e não cai em nenhuma das duas condições.
Você também pode usar o tipo de registro como **hierarquia personalizada** em um bloco de ação, para apontar especificamente para a conta do tipo Person Account dessa pessoa:
## Problemas frequentes
O perfil do usuário da integração não tem o tipo de Person Account como seu tipo padrão. Revise a seção de configuração no Salesforce no início desta página.
As contas que já foram criadas de forma errada não se corrigem sozinhas: é preciso convertê-las no Salesforce.
Quase sempre é uma regra de validação vinculada ao tipo de registro. Como a conta nasce com o tipo errado, são aplicadas regras que não correspondem a ela.
Confirme primeiro o tipo de registro; é muito provável que vários erros diferentes se resolvam com essa única alteração.
Em uma Person Account, `Name` é um campo calculado. Escreva `FirstName` e `LastName` no lugar dele.
Execute a [sincronização de objetos](/pt/docs/integrations/salesforce/object-sync). Se depois de sincronizar eles continuarem sem aparecer, escreva para o seu Customer Success Manager indicando que é uma integração com Person Accounts.
Revise o **campo de busca de telefone** da integração: ele tem que ser o mesmo campo onde estão salvos os números das suas Person Accounts existentes. Se apontar para outro campo, o Treble não as encontra e cria uma nova a cada vez.
Revise também que nenhum bloco tenha ativado "Criar um novo objeto" sobre `Account`.
## Próximos passos
O mecanismo por trás de quase todos esses problemas.
O que pode ser definido no momento da criação.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.