# Processe nomes e e-mails no Airtable com a GenderAPI

> Configure a extensão do Airtable e mapeie gênero, país e probability. Preserve os valores existentes, revise os registros não resolvidos e mantenha a V1 e a V2 separadas.

Canonical HTML: https://www.genderapi.io/pt/blog/como-determinar-o-genero-nos-dados-do-airtable

Last reviewed: 2026-09-29

## Mapeie campos com a extensão do Airtable

A extensão da GenderAPI lê um nome ou um endereço de e-mail de um campo que você escolhe e grava a previsão de gênero em um campo de destino separado. Você também pode mapear país, probability e nome encontrado e ignorar registros em que o campo de destino do gênero já tem um valor.

O código da extensão, revisado em 27 de setembro de 2026, usa endpoints da V1 para nomes e endereços de e-mail e os respectivos campos de resposta de nível superior. Este guia descreve o fluxo de trabalho nativo. A extensão instalada pode mudar independentemente do guia, então verifique as opções disponíveis antes de aplicar os mapeamentos abaixo.

- [GenderAPI.io no Airtable Marketplace](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [Documentação existente da V1](https://www.genderapi.io/pt/api-documentation/v1)

## Conecte a base e prepare os campos

- Abra a base certa, adicione a GenderAPI.io em Extensions e inicie a extensão. Conclua as etapas de conexão exibidas pela extensão.
- Escolha a chave cujos créditos serão usados. Verifique o saldo restante e se a chave pertence à conta certa da GenderAPI.
- Escolha a tabela e o campo de origem com nomes ou endereços de e-mail. Mantenha a entrada original no campo e crie campos separados para os resultados.
- Escolha o campo de destino obrigatório do gênero e eventuais destinos extras. Use um campo percent para um valor percentual formatado ou um campo numérico para manter a escala original de probability.
- Decida se os campos de destino do gênero já preenchidos devem ser preservados. A opção que os ignora também preserva valores de texto não resolvidos de uma execução anterior. Por isso, limpe somente os resultados que você quer processar novamente de forma intencional.

## Mapeie a entrada e a saída da extensão

| Configuração da extensão | Obrigatória | Valor e comportamento |
| --- | --- | --- |
| Chave de créditos | Sim | A chave da conta da GenderAPI escolhida fornece os créditos para as requisições processadas. |
| Tabela e campo de origem | Sim | A célula de origem contém um nome ou um endereço de e-mail. Células de origem vazias são ignoradas. |
| Campo de destino do gênero | Sim | Recebe o campo nativo gender. Mantenha um valor não resolvido separado de male e female. |
| Campo de destino do país | Não | Recebe o valor country retornado. É uma coluna de saída, e não um filtro de país da requisição. |
| Campo de destino de probability | Não | Recebe o valor probability da API antiga. Um campo percent recebe o valor dividido por 100, enquanto um campo numérico mantém a escala original. |
| Campo de destino de Found Name | Não | Recebe o nome retornado pela API nativa, quando disponível. Mantenha esse candidato inferido separado do valor de origem. |
| Ignorar campos de gênero preenchidos | Não | Preserva os registros em que o campo de destino já tem um valor, incluindo texto não resolvido. Verifique a opção antes de cada execução. |

O campo de origem pode conter tanto nomes quanto endereços de e-mail. Na implementação revisada, um valor com @ segue a rota de e-mail. Essa regra de roteamento não verifica se a caixa de correio existe.

## Teste um lote pequeno antes de processar a tabela

Comece com uma pequena tabela de teste com um nome, um endereço de e-mail, uma célula vazia e uma entrada ambígua. Verifique os campos de destino escolhidos e como o Airtable exibe a escala de probability antes de processar a tabela principal.

No código revisado, valores padrão não resolvidos podem aparecer como o texto null e probability 0. Algumas respostas nativas com falha também podem deixar esses valores padrão, enquanto um erro de conexão pode deixar um registro inalterado. Verifique o status da execução e as linhas afetadas: o texto null sozinho não comprova que a consulta foi bem-sucedida.

Verifique os valores existentes após a execução. Preserve os resultados não resolvidos para revisão em vez de atribuir um gênero por conta própria. Uma previsão baseada no nome não confirma a identidade de gênero de uma pessoa, e um país retornado não comprova onde alguém mora.

| O que você vê | O que fazer |
| --- | --- |
| Resultado esperado nas colunas previstas | Mantenha a entrada original e eventuais campos extras para que o mapeamento possa ser conferido. |
| O texto null ou probability 0 | Deixe o caso como não resolvido e verifique o status do processamento antes de decidir por uma nova consulta. |
| Um campo de destino já preenchido continua inalterado | Verifique a opção de ignorar. A preservação pode ser intencional. |
| Mensagem sobre chave ou créditos, ou resultado inalterado após um erro | Resolva o problema da conta ou da conexão e localize os registros afetados antes de começar de novo. |

## Controle o consumo de créditos e as novas execuções

A extensão nativa consulta os valores um por vez com a chave da GenderAPI escolhida. Uma nova execução nos mesmos registros que não forem ignorados pode enviar novas requisições e consumir créditos novamente. O plano do Airtable e a disponibilidade da extensão são independentes desse saldo da conta.

A saída nativa não mostra data/meta da resposta da V2, uma escolha explícita do modo de IA, um objeto usage por item nem o contrato de lote da V2. Use a documentação da V1 para este fluxo de trabalho e a alternativa de API separada abaixo quando precisar dessas opções.

A extensão envia os valores mapeados para processamento e grava os resultados de volta na sua base. Revise a política de tratamento de dados publicada e as permissões da extensão para os registros envolvidos e não inclua campos irrelevantes no mapeamento de origem.

- [Preços e créditos](https://www.genderapi.io/pt/price)
- [Política de privacidade](https://www.genderapi.io/pt/privacy-policy)

## Use a V2 quando precisar de uma resposta estruturada

Para uma integração personalizada, a GenderAPI V2 aceita nomes, endereços de e-mail e nomes de usuário e retorna campos explícitos de resultado, confiança, origem e uso. Configure essa conexão separadamente: ler o guia da V2 não altera o aplicativo instalado nem as colunas de saída dele.

Os exemplos em Python e Node.js cobrem requisições individuais, lotes, resultados unknown e erros operacionais. Comece pelo guia de autenticação e escolha o modo de IA antes de enviar uma requisição cobrada.

- [Autenticação na V2](https://www.genderapi.io/pt/docs/v2/authentication)
- [Campos da resposta na V2](https://www.genderapi.io/pt/docs/v2/responses)
- [Exemplo de integração em Python](https://www.genderapi.io/pt/integrations/python)
- [Exemplo de integração em Node.js](https://www.genderapi.io/pt/integrations/javascript)

## A extensão do Airtable usa a GenderAPI V2?

O código da extensão, revisado em 27 de setembro de 2026, usa endpoints da V1 para nomes e endereços de e-mail. Uma conexão personalizada com a V2 tem outros campos de requisição e de resposta e não atualiza a extensão instalada.

## Um campo de origem pode conter nomes e endereços de e-mail?

Sim. A extensão revisada envia valores não vazios com @ para a consulta de e-mail e os demais valores para a consulta de nome. Isso é um roteamento da entrada, e não uma verificação da caixa de correio.

## Por que probability aparece diferente em um campo de porcentagem?

A extensão divide o valor probability da API antiga por 100 para um campo percent do Airtable, para que o Airtable possa exibi-lo como porcentagem. Um campo numérico mantém a escala original. Não é o campo confidence da V2.

## A opção de ignorar preserva resultados não resolvidos?

Sim, quando o campo de destino já tem um valor, incluindo o texto null de uma execução anterior. Revise esses registros e limpe somente os valores que você quer processar novamente de forma intencional.

## Fontes e documentação

- [Página oficial no catálogo: Airtable](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [Documentação da V1 da GenderAPI](https://www.genderapi.io/pt/api-documentation/v1)
- [Documentação separada da API V2](https://www.genderapi.io/pt/api-documentation)