ENTRE EM CONTATO
artigo de ajuda_

Como integrar um formulário do Contact Form 7 com ADVBOX?

Neste passo-a-passo, vamos ver como configurar uma integração para que dados preenchidos em um formulário do Contact Form 7 em seu site WordPress sejam enviados automaticamente para o ADVBOX, um popular CRM para escritórios de advocacia.

Para isso, vamos usar o plugin CF7 to Webhook do brasileiro Mário Valney. A vantagem desse plugin é que ele nos dá mais controle sobre exatamente como nós vamos enviar os dados para o webhook. Além de poder enviar para diversos webhooks (ou sistemas) diferentes.

Documentação útil

Então vamos ao passo a passo:

Etapa 1) Obter as credenciais no ADVBOX

1. Acesse o painel do ADVBOX

2. No menu lateral, vá em “Configurações” > “Integrações e API”

3. Ative a opção “API ADVBOX”

4. Você será informado sobre uma cobrança adicional, concorde com os termos e ative.

5. Copie o token de integração, usaremos essa informação a seguir.

Etapa 2) Configurar o CF7 to Webhook

1. Instale e ative os plugins Contact Form 7 e CF7 to Webhook em seu site.

2. Crie um formulário de contato com o Contact Form 7 normalmente. Você vai notar que aparecerá uma nova aba nas configurações do formulário chamada “Webhook”.

3. Configure essa aba da seguinte forma (itens não mencionados ficam em branco):

  • Webhook
    • Integrar (Enviar para o Webhook): Ative esta opção para que o conteúdo do formulário seja enviado
    • URL do Webhook: Você deve inserir o seguinte URL: https://app.advbox.com.br/api/v1/customers.
  • Configurações
    • Enviar E-mail (Enviar o e-mail do CF7 normalmente): Desative se você quiser que o CF7 não envie mais o e-mail, apenas o webhook. Recomendo deixar essa opção ativada.
  • Configurações avançadas:
    • Cabeçalhos: você deve adicionar o seguinte conteúdo. Substitua [TOKEN DA INTEGRAÇÃO] pelo token copiado no passo 1:
      • Accept: application/json
        Authorization: [TOKEN DA INTEGRAÇÃO]Cntent-Type: application/json
  • Clique em Salvar

Etapa 3) Configurar o corpo da requisição

Para que o CF7 to Webhook envie o conteúdo do jeito que o CRM espera receber, além das configurações básicas acima, vamos precisar editar mais um campo na aba “Webhook”: Configurações Avançadas > Corpo.

Você pode adicionar um corpo personalizado parecido com esse:

{
  "users_id":,
  "customers_origins_id":,
  "name": "[your-name]",
  "email": "[your-email]"
}

Para entender o código acima, cada item está marcado entre aspas e, depois dos dois pontos, vem o conteúdo do item, nessa lógica:

"item": "conteúdo do item",

Você pode alterar o conteúdo de cada item com os shortcodes do CF7, como [your-name] e [your-email].

Além disso, você também pode usar tags especiais nativas do CF7 para metadados do formulário como nome da página ou horário. Nesse caso, você deve incluir as tags também no campo “Special Mail Tags” da aba “Webhook”.

Os campos “users_id”, “customers_origins_id” e “name” são obrigatórios. Se quiser saber mais sobre os itens que podem ser incluídos na requisição, aqui tem um detalhamento dos parâmetros aceitos pelo CRM.

Quando terminar, clique em Salvar.

Teste

Se quiser testar o funcionamento do JSON enviado pelo webhook, você pode usar esta ferramenta.

Ainda tem dúvidas?

Entre em contato para eu poder te ajudar!

WhatsAppE-mail