Integração com WordPress

Business Messaging for WbizTool é o plugin oficial para WordPress. Ele envia mensagens de WhatsApp a partir do seu número conectado quando algo acontece no seu site: um pedido do WooCommerce muda, um agendamento do WP Amelia é remarcado ou cancelado, ou um formulário do Contact Form 7 é enviado.

Antes de começar#

• Uma conta do Wbiztool com um número de WhatsApp conectado nas configurações do WhatsApp.
• Seu Client ID e sua chave de API, em Configurações → Chaves API.
• O ID do Cliente WhatsApp do número que vai enviar, mostrado nas configurações do WhatsApp.

Instalar o plugin#

1. Instale pelo WordPress

   No admin do WordPress, acesse Plugins → Add New (Plugins → Adicionar novo), pesquise Business Messaging for WbizTool, clique em Install Now (Instalar agora) e depois em Activate (Ativar). Você também pode baixá-lo no diretório de plugins do WordPress e enviar o arquivo zip em Plugins → Add New → Upload Plugin (Plugins → Adicionar novo → Enviar plugin). Se o envio falhar (por exemplo, por causa de um limite de tamanho de arquivo), descompacte o zip e copie a pasta business-messaging-for-wbiztool para /wp-content/plugins/ via FTP; depois ative o plugin em Plugins.

2. Abra as configurações do plugin

   Um novo menu WbizTool aparece na barra lateral do admin com quatro páginas: Settings (configurações), Templates (modelos), Test Messages (mensagens de teste) e Logs (registros).

Configurar o plugin#

1. Informe suas credenciais da API

   Em WbizTool → Settings, na seção API Configuration (configuração da API), preencha Client ID, API Key e WhatsApp Client ID e clique em Test Connection (testar conexão).

   Com as credenciais corretas, o Test Connection coloca na fila uma mensagem de teste real para o número fictício 10000000000, então ela aparece no seu histórico de mensagens do Wbiztool. Ela não pode ser entregue e aparece ali como falha; você pode ignorá-la. Se aparecer Unable to connect to WbizTool API. Please check your internet connection., o mais provável é que o seu Client ID, a chave de API ou o WhatsApp Client ID esteja errado, ou que o seu plano não tenha mais mensagens. Raramente indica um problema na sua conexão com a internet.

2. Defina as opções gerais

   Em General Settings (configurações gerais):

   • Default Country Code (código de país padrão): usado quando o país de cobrança de um pedido do WooCommerce não pode ser associado a um código de discagem. O padrão é 1, então altere para o seu país principal, por exemplo 91.
   • Test Mode (modo de teste): quando ativado, as mensagens são gravadas no log, mas não são enviadas.
   • Admin Notifications (notificações para o admin): essa caixa de seleção não tem efeito visível na versão 1.0.3, porque a página de configurações não tem um campo para o número de telefone do admin que ela usa. Para alertas ao admin sobre envios de formulário, use as configurações do Contact Form 7 abaixo.

3. Ative integrações e eventos

   Em Integration Settings (configurações de integração), ative cada plugin que você usa e marque os eventos que devem enviar mensagem. Uma integração só mostra as opções dela quando o plugin correspondente está ativo no seu site. Clique em Save Settings (salvar configurações).

4. Edite os modelos de mensagem

   Em WbizTool → Templates, escolha a aba WooCommerce, Amelia ou Contact Form 7, selecione um evento e edite o texto. A página lista as variáveis que você pode usar e mostra uma prévia em tempo real. Reset (redefinir) restaura o texto padrão.

5. Envie um teste

   Em WbizTool → Test Messages, envie uma mensagem para o seu próprio número para confirmar que tudo funciona e depois confira WbizTool → Logs.

WooCommerce#

As mensagens vão para o telefone de cobrança do pedido. O código do país vem do país de cobrança; se esse país não for reconhecido, é usado o Default Country Code.

Variáveis dos modelos:

Exemplo de modelo:

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

As mensagens vão para o telefone do cliente no agendamento. A página de configurações lista seis eventos:

• Booking Added (Frontend bookings) (agendamento adicionado pelo site)
• Booking Rescheduled (agendamento remarcado)
• Booking Cancelled (agendamento cancelado)
• Appointment Added (Backend) (compromisso adicionado pelo painel)
• Event Booking Saved (reserva de evento salva)
• Event Booking Updated (reserva de evento atualizada)

Variáveis disponíveis nos modelos do Amelia:

Contact Form 7#

Quando um formulário é enviado, o plugin pode mandar mensagem para você (o admin), para a pessoa que preencheu o formulário ou para os dois.

O plugin encontra o nome, o email, o telefone e a mensagem no seu formulário pelo nome do campo. Use nomes comuns como your-name, your-email, your-phone (ou phone, mobile, whatsapp), your-subject e your-message. A resposta automática ao cliente só é enviada quando um campo de telefone é encontrado. Peça o número com o código do país: o plugin reconhece só alguns códigos de país e, nos demais casos, usa o Default Country Code.

Variáveis dos modelos:

Cada campo do formulário também fica disponível pelo próprio nome, com os hífens trocados por sublinhados. Por exemplo, um campo chamado your-city vira {your_city}.

Exemplo de notificação para o administrador:

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

As quebras de linha da mensagem do visitante são removidas, então {message} chega em uma única linha.

Logs#

WbizTool → Logs lista as mensagens que o plugin tentou enviar, com a data, o tipo de evento, a integração, o telefone, a mensagem e o status. Use essa página para verificar se um evento foi disparado e se a mensagem foi enviada. Ela não mostra por que uma mensagem falhou.

Solução de problemas#

Para ver os erros de PHP do plugin, ative o log de depuração do WordPress em wp-config.php. Os erros são gravados em wp-content/debug.log. Desative-o novamente quando terminar.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);