Estou com um problema com a captação de dados de um campo de um form da minha LP (externa a hubspot).
A LP em questão leva o nome: PROMOBIS-25 - LP PROMO.
Preciso ajustar o campo: Pin Code
Tag do Campo: pincode_bis_promobis25_bot
O campo está ajustado para ser numérico, mas na verdade ELE PRECISA RECEBER INFORMAÇÃO ALPHANUMERICO.
Pelo que entendi é necessário realizar o ajuste via integração, como faço?
Ainda sobre o mesmo caso:
Um fornecedor mencionou que está com um erro no usuário dele ao conectar a integração via API.
Erro no upload para HubSpot:
{
“status”: “error”,
“message”: “Este app não recebeu todas as permissões (scopes) necessárias para fazer esta chamada.”,
…
“errors”: [
{
“message”: “Todas as permissões a seguir são obrigatórias.”,
“context”: {
“requiredGranularScopes”: [“files”]
}
}
]
}
Em resumo o usuário que estamos usando esta sem permissão para que possa enviar os arquivos.
Pelo que investiguei da documentação da API o que achei de referencia e este caso
“Você está tentando fazer upload de um arquivo com UploadFileToHubspotAsync(), mas seu app não tem a permissão (scope) files autorizada.”
fala de appid, cliente id e client secret, mas no nosso caso so veio a apikey.
O que faço?
Olá @TFidelix
Obrigado por entrar em contato com a Comunidade!
Gostaria de convidar alguns membros da comunidade que são especialistas no assunto para participar desta conversa.
@Brenner_Natal @caiodonald @IohranAraujo Vocês poderiam compartilhar alguma perspectiva sobre isso? Sua experiência seria muito apreciada.
Atenciosamente, Victor
Olá, @TFidelix
Pelo sintoma, o property do HubSpot mapeado para o campo pincode_bis_promobis25_bot foi criado como Number. Propriedades do tipo número rejeitam letras; para aceitar “alfa + num”, o tipo correto é Single‑line text. Você tem dois caminhos:
Opção A — Alterar o tipo do property existente (se permitido):
Settings → Data Management → Properties → busque pelo Internal name pincode_bis_promobis25_bot → Edit → mude o Field type para Single‑line text e salve. (A HubSpot permite editar tipo em vários casos; quando não permite, usar a Opção B.)
Opção B — Criar um novo property (recomendado se o HubSpot bloquear a troca):
Crie um property Single‑line text para Contact (ex.: “Pin Code – Alfanumérico”), internal name algo como pincode_bis_promobis25_text. Atualize o mapeamento do formulário/integrador para usar esse novo property. (Se precisar migrar valores legados do numérico para o texto, você pode exportar e reimportar, ou copiar via workflow/API.)
Pelo que descreveu você usa API para pegar os dados do formulário, correto? Se sim,
O endpoint de submissão para forms é (ainda) o v3 integration submit ou o v2, dependendo do seu uso. O payload deve conter fields: [{ name, value }]. Exemplo:
curl -X POST \
https://api.hsforms.com/submissions/v3/integration/submit/<PORTAL_ID>/<FORM_GUID> \
-H “Content-Type: application/json” \
-d ‘{
“fields”: [
{ “name”: “email”, “value”: “ana@exemplo.com” },
{ “name”: “pincode_bis_promobis25_bot”, “value”: “AB12-9Z” }
]
}’
A respeito da segunda dúvida/continuação:
A mensagem diz que o app não tem o escopo files. Além disso, API Keys foram descontinuadas no HubSpot, integrações devem usar Private App (token) ou OAuth. Com API key, uploads para Files API não são mais suportados. Você consegue corrigir da seguinte forma:
- Pare de usar API key e crie um Private App no portal do cliente:
Settings → Integrations → Private Apps → Create. Selecione os escopos necessários. Para trabalhar com arquivos, inclua o escopo files (e, conforme o caso, permissões de leitura/escrita). Salve e copie o Access Token. - Reautorize qualquer app público se você adicionou escopos depois.
Fontes / Evidências:
– HubSpot KB: tipos de propriedades e edição. knowledge.hubspot.com
– Forms API: endpoints e submissão (v2/v3). developers.hubspot.com
– API key sunset e migração para Private Apps. developers.hubspot.com
– Files API v3 e exigência de escopo files. developers.hubspot.com
Olá Comunidade!!
Muito obrigado por me marcar aqui, @Victor_Becerra !!
Sobre o comentário do @IohranAraujo :
“Opção A — Alterar o tipo do property existente (se permitido):
Settings → Data Management → Properties → busque pelo Internal name pincode_bis_promobis25_bot → Edit → mude o Field type para Single‑line text e salve. (A HubSpot permite editar tipo em vários casos; quando não permite, usar a Opção B.)”
É possível sempre alterar a mesma propriedade, contudo, você precisará deixar ela vazia em todos os registros do objeto que está usando + retirar ela de todos os ativos que ela está sendo usada (ex.: listas, fluxos de trabalhos, views personalizadas e etc). Dependedo do caso, vale a pena para não precisar criar uma outra com o nome parecido. Isso evita problemas de duplicidade a longo prazo.
Sobre o erro mencionado pelo @TFidelix :
"Erro no upload para HubSpot:
{
“status”: “error”,
“message”: “Este app não recebeu todas as permissões (scopes) necessárias para fazer esta chamada.”,
…
“errors”: [
{
“message”: “Todas as permissões a seguir são obrigatórias.”,
“context”: {
“requiredGranularScopes”: [“files”]
}
}
]
}
"
Você precisa, @TFidelix , ir até : canto superior direito > Configurações (icone de engrenagem) > Coluna lateral esquerda > Integrações > Aplicativos privados > selecionar a sua aplicação criada para isso > Editar escopos > e edite os escopos que estão dando erro. Isso signifca permitir que a sua API possa ler, escrever e muito mais, em cada objeto da HubSpot, mas precisa liberar por lá.
Saiba mais como fazer isso aqui.
Espero ter ajudado!
Abs