Resumo
Este artigo o ajuda a solucionar problemas comuns ao usar ações de API REST no Astra. Ele aborda problemas frequentes, como parâmetros de formulário ausentes, limitações com dados de lead, erros de autenticação e considerações de segurança importantes para manter suas integrações funcionando de forma confiável.
Instruções
Formulário enviado: parâmetros não estão sendo passados
Problema
Sua API REST recebe valores vazios ou ausentes quando um Formulário Personalizado é enviado.
Por que isso acontece
Isso geralmente ocorre quando o espaço reservado usado na configuração da API REST não corresponde exatamente ao nome do campo do formulário.
A correspondência é sensível a maiúsculas e minúsculas e baseada no sufixo do espaço reservado (a parte após o último .).
Como corrigir
Certifique-se de que o sufixo do espaço reservado corresponda exatamente ao nome do campo do formulário.
Exemplos:
Campo do formulário
first_name→ Espaço reservado{{first_name}}ou{{contact.first_name}}Campo do formulário
firstName→ Espaço reservado{{contact.first_name}}Razão: incompatibilidade de maiúsculas e minúsculas (
firstName≠first_name)
Depois de corrigir o espaço reservado, salve a ação e teste-a novamente.
Lead capturado: campos personalizados não funcionam
Problema
Você deseja enviar campos adicionais ou personalizados com o evento Lead capturado.
Por que isso acontece
O evento Lead capturado sempre envia uma estrutura de corpo de solicitação fixa. Campos personalizados não são suportados para este tipo de evento.
Qualquer configuração personalizada de request_body é ignorada.
O que você pode fazer em vez disso
Se você precisar enviar dados personalizados, use uma das seguintes opções:
Formulário enviado com um Formulário Personalizado
Disparo baseado em intenção com um corpo de solicitação personalizável
Essas opções permitem que você controle exatamente quais dados são enviados para sua API.
Erros de autenticação
Problema
Sua API retorna um erro 401 Não Autorizado.
Como corrigir
Verifique se sua chave de API ou token está correta
Certifique-se de que o token não expirou
Depois de atualizar as credenciais, teste a ação novamente.
Notas de segurança
O Astra inclui proteções internas para proteger seus dados e integrações.
Credenciais protegidas
Chaves de API e senhas são mascaradas (
*****) ao visualizar detalhes da ação
Proteção contra falsificação de solicitação de servidor (SSRF)
Solicitações para endereços de rede internos ou privados são bloqueadas automaticamente
Modo de teste disponível
Use o modo de teste para validar sua ação de API REST sem afetar dados ao vivo ou análises
Seguir essas diretrizes ajudará a solucionar problemas rapidamente e manter suas ações de API REST seguras e confiáveis.