Olá Integração Bonsai para o Gravity Forms

Como ativo o *plugin*?

Após comprar a Integração Hello Bonsai para Gravity Forms, terá de instalar o plugin no seu site WordPress. Vamos percorrer esse processo.

Passo 1: Instalação

Inicie sessão no seu site WordPress e navegue até Plugins → Adicionar plugin → Enviar plugin → Instale o ficheiro zip e ative-o.

Passo 2: Registar o Plugin

Navegue até Formulários → Definições → Hello Bonsai e clique Ativar Licença na secção Licença. Insira a sua chave de licença e ative-a.

Passo 3: Ligue a sua conta Hello Bonsai

Na sua conta do Hello Bonsai, aceda a Definições → A minha conta → Integrações → API Bonsai (novo) e cria uma chave de API (começa com bonsai_at_). De volta ao WordPress, cole-o na seção Ligação Hello Bonsai e clique em Guardar Configurações – a chave é verificada com o Hello Bonsai e a conta é adicionada num único passo.

Passo 4: Criar um feed

Abra o formulário a partir do qual quer capturar potenciais clientes, vá ao separador Definições → Hello Bonsai e adicione um canal de dados. Mapeie os seus campos de Nome e Email, e depois ative as secções de Empresa e Negócio, caso os pretenda. E já está – a submissão seguinte vai parar ao Hello Bonsai.

Detalhes da Funcionalidade

O que é criado no Hello Bonsai

Cada feed executa uma cadeia de até quatro passos em cada submissão:

1. Empresa (opcional) – correspondido por domínio e/ou nome, ou criado quando nada corresponde.
2. Contacto (sempre) – encontrado por e-mail exato e atualizado, ou criado e associado à empresa.
3. Combinado (opcional) – aberto na fase do funil de vendas escolhida, atribuído, avaliado e associado ao contacto e à empresa.
4. Comentar (opcional) – a submissão publicada sobre o novo acordo como registo escrito.

Se um passo posterior não puder ser concluído, os passos anteriores ainda contam – a inscrição fica marcada parcialmente sincronizado Com uma explicação em linguagem simples sobre exatamente qual etapa precisa de atenção, o Re-send retoma de onde parou.

Os campos de contato que ele mapeia

• Nome (Obrigatório) – Os campos de nome do Gravity Forms são unidos automaticamente (Nome + Sobrenome).
• Correio eletrónico (obrigatório) – a chave exclusiva Hello Bonsai corresponde aos contatos por.
• Cargo
• Número de telefone

Estes são os campos que a API do Hello Bonsai aceita em um contato atualmente. À medida que o Hello Bonsai expande sua API (campos personalizados estão em seus planos), este plugin crescerá junto.

Se o contato já existir, Você escolhe o comportamento para cada feed: atualizar o contato existente com os valores enviados (padrão) ou deixá-lo inalterado. De qualquer forma, o envio é vinculado ao contato existente – nenhum duplicado é criado e um campo opcional em branco nunca sobrescreve dados reais no Hello Bonsai.

Correspondência de empresas

O Hello Bonsai trata os domínios de sites como únicos em toda a sua conta – um domínio pode pertencer a apenas uma empresa – o que torna a correspondência de domínios extremamente confiável. A seção Empresa de cada feed oferece três modos de correspondência:

• Domínio, depois nome da empresa (padrão) – tente primeiro o domínio e, em caso afirmativo, utilize uma correspondência exata do nome (sem distinção entre maiúsculas e minúsculas).
• Somente domínio
• Apenas o nome da empresa

Mapeie um campo de site/domínio e o plugin normalizará qualquer informação digitada pelos visitantes – https://www.acme.com/contact torna-se acme.com antes da correspondência. Se nenhum campo de domínio estiver mapeado, o domínio do contato será utilizado. endereço de email O sistema utiliza automaticamente provedores de e-mail gratuitos (gmail.com, outlook.com, yahoo.com, icloud.com e dezenas de outros) e os ignora, para que você nunca seja redirecionado para uma empresa chamada "Gmail". Os desenvolvedores podem ajustar a lista de provedores gratuitos com um filtro.

Quando nada combina, Para cada feed, você escolhe: criar a empresa (padrão) ou ignorar. As empresas criadas recebem o nome do campo "Nome da Empresa" mapeado ou do domínio quando nenhum nome foi fornecido — a mesma convenção usada pelo próprio Hello Bonsai.

A correspondência com uma empresa existente nunca a edita. E quando um contato existente envia uma solicitação para uma empresa à qual ainda não está vinculado, o plugin cria o vínculo sem alterar o contato principal da empresa – algo que a API do Hello Bonsai torna surpreendentemente simples, mas que agora é resolvido automaticamente para você.

Ofertas

Ative a seção "Negócios" e cada lead capturado poderá abrir um negócio no seu quadro de negócios do Hello Bonsai. O Hello Bonsai exige que cada negócio pertença a uma empresa, portanto, a seção "Empresa" precisa estar habilitada e configurada corretamente — o editor de feed e os resultados da entrada deixam isso claro caso não esteja.

• Título do negócio – Suporta tags de mesclagem do Gravity Forms, por exemplo. Website lead – {Name:1}. O valor padrão é o título do formulário.
• Valor do negócio – mapeie qualquer campo de formulário que contenha um valor em dólares. Os campos de produto reconhecem a moeda (o preço, não o rótulo), e os campos numéricos também funcionam perfeitamente.
• Fase de desenvolvimento – um seletor em tempo real dos seus estágios atuais no tabuleiro de negociação, extraídos da sua conta Hello Bonsai. Por padrão, seleciona o primeiro estágio.
• Atribuir a – não atribuído, membro da conta conectada ou qualquer membro ativo da equipe (também obtido em tempo real).
• Criar um acordo – em cada envio, ou apenas quando o contato for novo. A segunda opção evita que clientes recorrentes acumulem negócios duplicados.

Comentários sobre a oferta

Ative a opção de comentários e o plugin publicará a oferta na nova proposta criada – o modelo padrão é {form_title} seguido pela {all_fields}, E você pode personalizá-lo com quaisquer tags de mesclagem. Quem aceitar a oferta no Hello Bonsai verá a consulta completa sem sair do quadro de ofertas. (Os comentários do Hello Bonsai são texto simples; a formatação é removida pelo Hello Bonsai.)

Resultados da inscrição e reenvio

Cada inscrição recebe um Olá Bonsai caixa na página de detalhes mostrando exatamente o que aconteceu:

• Sincronizado – Todas as etapas solicitadas foram concluídas.
• Parcialmente sincronizado – O contato está seguro no Hello Bonsai, mas uma etapa posterior (empresa, negócio ou comentário) requer atenção. A mensagem indica exatamente qual etapa e o motivo.
• A sincronização falhou – nada pôde ser escrito; a mensagem inclui o próprio erro do Hello Bonsai.

Os IDs de Contato, Empresa e Negócio criados são Links clicáveis diretamente para sua conta Hello Bonsai, E o ID da solicitação da Hello Bonsai é exibido em qualquer conversa de suporte.

O Reenviar para a Hello Bonsai O botão tenta novamente uma sincronização falha ou parcial com segurança: empresas e contatos são correspondidos novamente em vez de duplicados, um negócio já criado nunca é recriado e um comentário já publicado nunca é publicado duas vezes. Ele também funciona em entradas anteriores ao plugin – abra qualquer entrada mais antiga e clique. Enviar para Hello Bonsai para preencher o espaço.

Mesclar tags

{bonsai_contact_id} – o ID de contato do Hello Bonsai vinculado a esta entrada.

{bonsai_company_id} – o ID da empresa Hello Bonsai vinculado a esta entrada.

{bonsai_deal_id} – O ID da oferta Hello Bonsai foi aberto para esta entrada.

Use-os em notificações, confirmações e payloads de webhook. Os feeds são processados de forma síncrona durante o envio, portanto, os IDs já estão resolvidos quando o Gravity Forms envia as notificações do mesmo envio – sem condições de corrida. As tags para registros que não foram criados (por exemplo, nenhuma oferta para um remetente recorrente) simplesmente chegam vazias.

Múltiplas contas

Agências e equipes com várias marcas podem conectar mais de uma conta Hello Bonsai. Cada conta é verificada ao ser adicionada, listada em uma tabela de Contas Conectadas com opções de teste e remoção, e cada feed escolhe para qual conta enviar as informações — uma conta padrão é usada quando o feed não especifica uma. As credenciais são armazenadas no servidor, no banco de dados do WordPress, e nunca são exibidas novamente na página após o salvamento.

Notificações de erro e resincronização

Notificações de erro – Adicione um endereço de e-mail em Formulários → Configurações → Hello Bonsai → Relatório de erros e você receberá um e-mail sempre que uma sincronização falhar ou for concluída apenas parcialmente. O e-mail inclui o feed, a mensagem de resultado exata, o ID da solicitação do Hello Bonsai e um link direto para a entrada, para que você possa investigar e reenviar com apenas dois cliques.

Ressincronização de edição de registo – Opcionalmente, execute novamente os feeds de um formulário quando uma entrada for editada no painel de administração do WordPress, para que o contato e a empresa vinculados no Hello Bonsai recebam os valores corrigidos. As ofertas nunca são criadas duas vezes para a mesma entrada, independentemente de quantas vezes a sincronização seja feita.

Perguntas Frequentes

Onde posso obter uma chave de API do Hello Bonsai?

Na sua conta Hello Bonsai em Configurações → API, Crie uma chave de API – ela começa com bonsai_at_. Cole-a na página de configurações do plugin e ela será verificada e armazenada em uma única etapa. Qualquer conta Hello Bonsai que possa criar uma chave de API funciona com este plugin.

Por que não foi criada uma proposta para a minha inscrição?

O Hello Bonsai exige que cada negócio pertença a uma empresa, portanto, a seção "Empresa" do feed deve estar ativada e deve corresponder a uma empresa ou criar uma. A caixa do Hello Bonsai na entrada informa exatamente o que aconteceu em cada etapa – se a empresa foi ignorada ou não foi possível resolver o problema, a mensagem do negócio indica isso em linguagem simples.

O que acontece quando a mesma pessoa envia o formulário duas vezes?

O plugin encontra o contato existente pelo e-mail – nenhuma duplicata é criada. Para cada feed, você escolhe se o envio atualiza os dados do contato ou os deixa inalterados, e se abre uma nova oportunidade de negócio ou apenas oportunidades no primeiro contato. As empresas são reconectadas da mesma forma.

Posso enviar inscrições que foram submetidas antes de eu instalar o plugin?

Sim. Abra qualquer entrada e clique. Enviar para Hello Bonsai na caixa Hello Bonsai. Ele executa os feeds do formulário nessa entrada com proteção total contra duplicados, portanto, o preenchimento retroativo é seguro mesmo que algumas dessas pessoas já estejam no seu Hello Bonsai.

Posso mapear campos personalizados ou enviar arquivos para upload?

Ainda não – a API pública do Hello Bonsai não suporta campos personalizados, anexos de arquivos ou webhooks. O plugin mapeia tudo o que a API aceita atualmente e, conforme o Hello Bonsai expandir a API, este plugin também será atualizado. Enquanto isso, a opção de comentário da oferta é uma ótima maneira de enviar a proposta completa (todos os campos) para quem estiver trabalhando no lead.

Posso enviar apenas determinadas fotos para a Hello Bonsai?

Sim, todos os feeds são compatíveis com a lógica condicional do Gravity Forms ("Enviar para Hello Bonsai se..."), permitindo que você controle a sincronização com base em qualquer campo: apenas orçamentos qualificados, apenas determinadas seleções de serviço, apenas conteúdo não spam, ou o que melhor se adequar ao seu formulário.

Que dados saem do meu site?

Apenas os valores que você mapeia no feed (mais o modelo de comentário, se ativado) são enviados diretamente para a API oficial do Hello Bonsai via HTTPS. Nada é enviado para terceiros, e nada é enviado a menos que as condições do feed sejam atendidas.

Funciona com cache/CDN e otimização de scripts?

Sim, sem nada para configurar. Toda a sincronização ocorre no servidor quando o formulário é enviado – não há scripts no front-end, portanto, não há nada a excluir dos plugins de cache, minificação ou adiamento.

Funciona com o Gravity Forms habilitado para AJAX?

Sim. Funciona com Formulários AJAX e envios padrão (não AJAX) do Gravity Forms.

O que acontece se o Hello Bonsai estiver lento ou inacessível durante o envio de um formulário?

Seu visitante está protegido: o plugin tenta novamente falhas temporárias brevemente, mas limita o tempo total gasto em um envio (40 segundos por padrão, ajustável por meio de um filtro), de modo que uma API lenta nunca poderá travar seu formulário. Qualquer falha que não puder ser concluída é registrada honestamente na entrada como falha ou parcial — e, se você tiver configurado um e-mail de notificação de erro, você será notificado —, então um clique em "Reenviar" finaliza o processo assim que o Hello Bonsai estiver funcionando normalmente.

Funciona com uma rede WordPress Multisite?

Sim. Cada subsite conecta sua própria conta (ou contas) do Hello Bonsai e configura seus próprios feeds, e a desinstalação limpa tudo na rede. Com uma licença ilimitada, o Modo de Rede permite que você envie uma única chave de licença para cada subsite de uma só vez.

Está pronto para tradução?

Sim, todas as strings são traduzíveis. Você pode usar a versão gratuita. Plugin Loco Translate Para criar uma tradução para o idioma/localidade do seu site. Se você nunca usou o Loco Translate antes, aqui está um guia. um tutorial para iniciantes.

Ganchos

Filtros

pb_gfhellobonsai_contact_payload

Filtre o corpo do contato antes de enviá-lo para o Hello Bonsai – ajuste o nome, e-mail, cargo ou número de telefone na saída.

Parâmetros:

• $contact_body (variedade) – Os campos de contato formatados (nome, e-mail, cargo, número de telefone).
• $feed (variedade) – O feed Gravity Forms.
• $entry (variedade) – A entrada atual.
• $form (variedade) – O formulário atual.

// Title-case every contact name on its way into Hello Bonsai.
add_filter( 'pb_gfhellobonsai_contact_payload', function( $contact_body, $feed, $entry, $form ) {
    if ( isset( $contact_body['name'] ) ) {
        $contact_body['name'] = ucwords( strtolower( $contact_body['name'] ) );
    }
    return $contact_body;
}, 10, 4 );

pb_gfhellobonsai_company_payload

Filtre o corpo da empresa antes de criá-la – ajuste o nome ou os domínios.

Parâmetros:

• $body (variedade) – Os campos da empresa (nome, domínios).
• $feed (variedade) – O feed Gravity Forms.
• $entry (variedade) – A entrada atual.
• $form (variedade) – O formulário atual.

// Prefix companies created from forms so they're easy to spot in Hello Bonsai.
add_filter( 'pb_gfhellobonsai_company_payload', function( $body, $feed, $entry, $form ) {
    $body['name'] = 'Lead: ' . $body['name'];
    return $body;
}, 10, 4 );

pb_gfhellobonsai_deal_payload

Filtre o conteúdo da transação antes de enviá-la – ajuste o título, o valor, a etapa ou o responsável de forma programática.

Parâmetros:

• $deal (variedade) – Os campos do negócio (título, company_id, contact_id, board_group_id, assignee_member_id, deal_value).
• $feed (variedade) – O feed Gravity Forms.
• $entry (variedade) – A entrada atual.
• $form (variedade) – O formulário atual.

// Route big-budget leads into a different pipeline stage.
add_filter( 'pb_gfhellobonsai_deal_payload', function( $deal, $feed, $entry, $form ) {
    if ( isset( $deal['deal_value'] ) && (float) $deal['deal_value'] >= 10000 ) {
        $deal['board_group_id'] = 'your-priority-stage-uuid';
    }
    return $deal;
}, 10, 4 );

pb_gfhellobonsai_free_email_domains

Filtre a lista de domínios de e-mail gratuitos excluídos da correspondência de empresas baseada em e-mail (gmail.com, outlook.com, yahoo.com, icloud.com e dezenas de outros por padrão).

Parâmetros:

• $free_domains (variedade) – Domínios em minúsculas a serem excluídos.

// Also treat a local ISP's addresses as personal email.
add_filter( 'pb_gfhellobonsai_free_email_domains', function( $free_domains ) {
    $free_domains[] = 'myisp.example';
    return $free_domains;
} );

pb_gfhellobonsai_record_url

Filtrar o URL do aplicativo Hello Bonsai usado como link para um registro sincronizado na caixa de entrada. Retornar uma string vazia para exibir um ID simples, sem link.

Parâmetros:

• $url (corda) – O URL padrão do aplicativo para registro.
• $type (corda) – Um dos contatos, empresa, negócio.
• $id (int) – O ID do registro Hello Bonsai.

pb_gfhellobonsai_run_time_budget

Ajuste o limite de tempo (em segundos) compartilhado por cada solicitação do Hello Bonsai em uma execução do feed. Os feeds são processados de forma síncrona durante o envio, portanto, este é o limite máximo de tempo que uma API com desempenho abaixo do esperado pode manter seu visitante conectado. O padrão é 40.

Parâmetros:

• $seconds (flutuador) – O orçamento em segundos. Valor padrão: 40.

// Tighten the budget on high-traffic sites.
add_filter( 'pb_gfhellobonsai_run_time_budget', function( $seconds ) {
    return 20.0;
} );

pb_gfhellobonsai_runtime_allowed

Ignora a restrição de licença para processamento de feeds. Principalmente útil em ambientes de teste e desenvolvimento.

Parâmetros:

• $allowed (bool) – Se o processamento de ração é atualmente permitido pela licença.

pb_gfhellobonsai_api_base_url

Substitui a URL base da API Hello Bonsai. Útil apenas para desenvolvimento e testes com uma API simulada – você nunca precisará disso em produção.

Parâmetros:

• $url (corda) – O URL base da API. Padrão https://app.hellobonsai.com/public-api/v1.