Guia de configuração

O app adiciona aos workflows da HubSpot a ação "Formatar telefone para WhatsApp (Brasil)". Ela lê o telefone de uma propriedade do registro e devolve o número no formato que o WhatsApp usa no Brasil: +55 + DDD + número, com ou sem o 9º dígito conforme o DDD.

Requisitos

• Uma conta HubSpot com acesso a workflows.
• Permissão para instalar apps na conta.

1. Instalar o app

1. Abra a página do app no HubSpot App Marketplace e clique em Instalar.
2. Escolha a conta HubSpot e confirme o acesso.

O app pede apenas a permissão básica de conexão (oauth). Ele não lê nem altera registros do CRM por conta própria: só recebe o telefone que o workflow envia.

2. Adicionar a ação ao workflow

1. Em Automação → Workflows, crie ou edite um workflow (contatos, empresas, negócios, tickets ou objetos personalizados).
2. Clique em +, procure "Formatar telefone para WhatsApp (Brasil)" na seção Aconcaia e adicione a ação.
3. Preencha os campos:
   • Telefone: selecione a propriedade que guarda o número, por exemplo Telefone ou Celular.
   • DDD padrão (opcional): DDD usado quando o número vem sem DDD, por exemplo 11. Em branco, esses números saem como inválidos.
   • Regra do 9º dígito (opcional): deixe Padrão WhatsApp, a não ser que precise do formato Anatel (veja a seção 4).

3. Gravar o número formatado

A ação não altera o registro: ela devolve saídas, que você grava com as ações nativas da HubSpot.

1. Depois da ação, adicione uma ramificação Se/então pela saída Status da formatação, com o ramo Formatado.
2. No ramo Formatado, adicione Editar registro. Escolha a propriedade de destino (por exemplo, uma propriedade WhatsApp) e use o valor Número WhatsApp (+55…) da ação anterior.

Importante: faça a ramificação antes do Editar registro. Para números vazios ou inválidos, as saídas vêm em branco. Copiar sem ramificar apagaria a propriedade de destino.

Saídas da ação

O histórico do workflow mostra uma mensagem por execução, por exemplo "Número WhatsApp: +5511912345678" ou "O DDD não existe no Brasil".

4. Como a regra do 9º dígito funciona

O WhatsApp não segue exatamente o formato da Anatel. Os estados que adotaram o 9º dígito primeiro registraram as contas com o 9; nos outros, as contas antigas ficaram sem ele.

As outras opções:

• Sempre com 9 (Anatel): todo celular sai com 9 dígitos.
• Sempre sem 9: todo celular sai com 8 dígitos.

5. Formatos aceitos

• Máscaras e espaços: (11) 91234-5678, 11 9 1234 5678.
• Código do país: +55, 55, 0055.
• Zero de tronco e código de operadora: 011…, 0 41 11….
• Números estrangeiros: começando com + ou 00 e outro código de país, saem como Internacional, sem alteração, no formato +<dígitos>.

Perguntas frequentes

O app guarda os telefones? Não. O número é processado na hora e descartado. Os logs técnicos registram apenas o ID da conta, o ID do workflow, o tipo de objeto e o status.

Funciona com WhatsApp Business em número fixo? Sim. Fixos são formatados sem alteração e marcados como Fixo.

O número saiu sem o 9, mas o contato usa o 9 no WhatsApp. A regra padrão segue o comportamento mais comum das contas brasileiras. Se a sua base for diferente, use Sempre com 9 (Anatel).

Suporte

falecom@aconcaia.com · aconcaia.com/apps/formatador-whatsapp