A integração entre WordPress e Bitrix24 permite automatizar cadastros, leads e formulários de contato, economizando tempo e reduzindo erros manuais.
Neste guia, você vai aprender como conectar o WordPress à API do Bitrix24 usando PHP.
O que é o Bitrix24?
O Bitrix24 é uma plataforma de CRM, automação de vendas e comunicação interna.
Ele oferece uma API REST que permite criar, editar e consultar dados como leads, contatos, negócios, tarefas, produtos e usuários.
Pré-requisitos
Antes de começar, você precisa ter:
- Um site WordPress com acesso ao código (FTP ou painel do servidor);
- Uma conta Bitrix24 (nuvem ou self-hosted);
- O Webhook da API do Bitrix24 (vamos gerar abaixo).
Passo 1: Gerar o Webhook no Bitrix24
- No Bitrix24, vá até: Menu → Desenvolvedores → Webhooks → Adicionar Webhook.
- Escolha o tipo “Entrada”.
- Marque as permissões desejadas (por exemplo,
crm,user,lead). - Copie o link gerado, que será algo como:
https://seudominio.bitrix24.com/rest/1/abc123xyz456/
Esse é o seu endpoint base para todas as requisições.
Passo 2: Criar um arquivo PHP no WordPress
Você pode criar um pequeno script dentro do seu tema ou em um plugin personalizado.
Crie o arquivo:
wp-content/plugins/wp-bitrix-integration/wp-bitrix-integration.php
E adicione:
<?php
/**
* Plugin Name: WP Bitrix Integration
* Description: Conecta o WordPress à API do Bitrix24.
* Version: 1.0
* Author: Seu Nome
*/
add_action('wp_ajax_send_to_bitrix', 'send_to_bitrix');
add_action('wp_ajax_nopriv_send_to_bitrix', 'send_to_bitrix');
function send_to_bitrix() {
$webhook = 'https://seudominio.bitrix24.com/rest/1/abc123xyz456/';
$leadData = [
'fields' => [
'TITLE' => 'Novo lead do site',
'NAME' => sanitize_text_field($_POST['name']),
'EMAIL' => [['VALUE' => sanitize_email($_POST['email']), 'VALUE_TYPE' => 'WORK']],
'PHONE' => [['VALUE' => sanitize_text_field($_POST['phone']), 'VALUE_TYPE' => 'WORK']],
'COMMENTS' => sanitize_textarea_field($_POST['message']),
]
];
$response = wp_remote_post($webhook . 'crm.lead.add.json', [
'body' => $leadData,
]);
if (is_wp_error($response)) {
wp_send_json_error(['message' => 'Erro ao enviar lead.']);
} else {
wp_send_json_success(['message' => 'Lead enviado com sucesso!']);
}
}Passo 3: Criar o formulário no WordPress
Em qualquer página ou template, insira o seguinte HTML:
<form id="leadForm">
<input type="text" name="name" placeholder="Seu nome" required>
<input type="email" name="email" placeholder="Seu e-mail" required>
<input type="tel" name="phone" placeholder="Seu telefone">
<textarea name="message" placeholder="Mensagem"></textarea>
<button type="submit">Enviar</button>
</form>
<div id="result"></div>
<script>
document.querySelector('#leadForm').addEventListener('submit', async (e) => {
e.preventDefault();
const formData = new FormData(e.target);
const response = await fetch('<?php echo admin_url("admin-ajax.php?action=send_to_bitrix"); ?>', {
method: 'POST',
body: formData
});
const result = await response.json();
document.querySelector('#result').innerText = result.data?.message || 'Erro ao enviar';
});
</script>
Passo 4: Testar a integração
- Vá até a página do formulário;
- Preencha e envie;
- Acesse CRM → Leads no Bitrix24;
- Você deve ver o novo lead criado automaticamente!
Dica: criando uma classe para organizar o código
Você pode transformar o código em uma classe PHP (como BitrixIntegration) para:
- Centralizar funções;
- Reutilizar em outros plugins;
- Adicionar logs e tratamento de erros.
Integrar o WordPress à API do Bitrix24 é simples e poderoso.
Com poucos passos, você pode automatizar a captura de leads, formulários e até criar negócios automaticamente no CRM.
