Google Address Validation

Visão geral

O Google Address Validation é uma API do Google Cloud que verifica a precisão de endereços postais, padroniza seus componentes e retorna informações de geocodificação e entregabilidade. Com a integração no SquadOS, seus agentes podem validar endereços em tempo real antes de usá-los em pedidos, cadastros ou qualquer fluxo que dependa de dados de localização precisos.

• Documentação na Composio: docs.composio.dev/toolkits/google_address_validation

Autenticação

Esta ferramenta utiliza chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
api_key	Sim	Chave de API do Google Cloud com a API Address Validation habilitada.

Como obter a credencial

1. Acesse o Google Cloud Console e faça login com sua conta Google.
2. Crie um projeto (ou selecione um existente) no seletor de projetos no topo da página.
3. No menu lateral, vá em APIs e Serviços → Biblioteca.
4. Pesquise por Address Validation API e clique em Ativar.
5. Vá em APIs e Serviços → Credenciais e clique em + Criar credencial → Chave de API.
6. Copie a chave gerada — esse é o valor a usar no campo api_key ao conectar no SquadOS.

Dica

Restrinja a chave de API ao método da Address Validation API nas configurações de credencial do Google Cloud para limitar o escopo de uso e aumentar a segurança.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Google Address Validation.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Fornecer feedback de validação

GOOGLE_ADDRESS_VALIDATION_PROVIDE_VALIDATION_FEEDBACK

Envia feedback sobre uma tentativa de validação de endereço. Use após concluir uma sequência de validação de endereço.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
conclusion	string (VALIDATION_CONCLUSION_UNSPECIFIED | VALIDATED_VERSION_USED | USER_VERSION_USED | UNVALIDATED_VERSION_USED | UNUSED)	Sim	Resultado da sequência de tentativas de validação. Não deve ser VALIDATION_CONCLUSION_UNSPECIFIED.
responseId	string	Sim	ID da resposta à qual este feedback se refere; o responseId da primeira resposta de validateAddress.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Validar endereço

GOOGLE_ADDRESS_VALIDATION_VALIDATE_ADDRESS

Valida e padroniza endereços postais. Use quando precisar de análise detalhada, geocodificação e veredicto de entregabilidade de um endereço.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
address	object	Sim	Endereço a validar; use addressLines para endereços não formatados.
sessionToken	string	Não	Token de sessão de autocompletar (base64 seguro para URL, máx. 36 caracteres).
enableUspsCass	boolean	Não	Habilita o modo USPS CASS (somente EUA/Porto Rico).
languageOptions	object	Não	Opções de idioma para pré-visualização.
previousResponseId	string	Não	Para requisições de acompanhamento; omitir na primeira requisição.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.