Integração de CRM para gestão de desentupimento residencial e comercial

Como conectar seu site WordPress a um CRM para gerenciar chamados de desentupimento sem criar gargalos manuais ou perder histórico do cliente?

A maioria das desentupidoras ainda opera com planilhas, WhatsApp e anotações em papel. Isso gera retrabalho, falhas de comunicação entre equipe de campo e escritório, e impossibilita métricas reais de conversão e tempo de resposta. A integração via API resolve isso — desde que a arquitetura respeite performance, segurança e a realidade operacional do setor.

Mapeamento de fluxos antes de escrever uma linha de código

Liste cada origem de lead: formulário de orçamento no site, botão de WhatsApp, ligação telefônica, e-mail, indicação. Para cada uma, defina o que entra no CRM: nome, telefone, endereço completo (com CEP validado), tipo de imóvel (residencial/comercial), descrição do problema, urgência, fonte de aquisição. Padronize status: novo, qualificado, agendado, em atendimento, finalizado, cancelado, perdido. Esse dicionário evita campos “livres” que depois não servem para relatório.

Autenticação e permissões: o mínimo necessário

Crie um usuário api-crm-integracao no WordPress com função editor ou custom role que só tenha edit_posts (para criar/atualizar atendimentos) e read_private_posts. Gere Application Passwords nas configurações do usuário — nunca use senha de admin. No CRM, armazene esse token em cofre de segredos (AWS Secrets Manager, HashiCorp Vault, ou variáveis de ambiente criptografadas). Rotacione a cada 90 dias via script automatizado.

Webhooks idempotentes e retentativa inteligente

O CRM deve disparar webhook para /wp-json/crm/v1/atendimentos a cada mudança de status. O payload leva event_id (UUID único por evento), timestamp, tipo_evento, dados. No WordPress, verifique se event_id já foi processado em tabela wp_crm_webhook_log. Se sim, retorne 200 OK sem reprocessar. Se falhar (timeout, erro 500), o CRM reenvia com backoff exponencial: 1min, 5min, 15min, 1h, 6h, 24h. Use Action Scheduler para processar em background e não travar a requisição HTTP.

Sincronização bidirecional de agenda e equipe

Técnicos no campo usam app móvel que escreve no CRM. Quando o técnico marca “cheguei no local”, o CRM envia webhook → WordPress atualiza post type atendimento com meta status=em_andamento e tecnico_id. O cliente vê no painel /minha-conta/atendimentos/ em tempo real via AJAX polling (a cada 30s) ou Server-Sent Events. Ao finalizar, o técnico anexa fotos, laudo e assinatura digital; tudo sobe pro CRM e replica no WordPress via update_post_meta e wp_update_post.

LGPD na prática: consentimento, criptografia, exclusão

No formulário de orçamento, inclua checkbox obrigatório: “Autorizo o armazenamento dos meus dados para contato e execução do serviço conforme Política de Privacidade”. Salve o timestamp e IP do consentimento em wp_postmeta do lead. Criptografe campos sensíveis (endereço completo, CPF/CNPJ) com openssl_encrypt (AES-256-GCM) antes de gravar no banco. Crie endpoint REST /wp-json/crm/v1/anonimizar/{lead_id} que só responde a requisições autenticadas do próprio usuário (verifique current_user_can('read_post', $lead_id)).

Cache que não quebra tempo real

Use wp_cache_set com grupo crm_atendimentos apenas para listas estáticas (ex: “tipos de serviço”, “bairros atendidos”). Para dados dinâmicos (status do atendimento, próximo agendamento), desative cache de página com nocache_headers() nas rotas /minha-conta/* e invalide chaves específicas nos hooks:

add_action('save_post_atendimento', function($post_id) {
    wp_cache_delete('atendimento_' . $post_id, 'crm_atendimentos');
    wp_cache_delete('cliente_' . get_post_meta($post_id, 'cliente_id', true), 'crm_atendimentos');
});
add_action('wp_rest_insert_post', function($post, $request, $creating) {
    if ($post->post_type === 'atendimento') {
        wp_cache_delete('atendimento_' . $post->ID, 'crm_atendimentos');
    }
});

Observabilidade: saiba que quebrou antes do cliente reclamar

Registre cada webhook recebido em tabela custom wp_crm_webhook_log (id, event_id, tipo, status_code, response_body, created_at). Configure alerta no Grafana/Prometheus ou via plugin simples que roda wp_cron a cada 5min: se houver >5 falhas (status >= 400) nos últimos 15min, dispare e-mail para tecnico@dominio.com e poste no canal #alertas-crm do Slack via webhook. No admin, crie página “Saúde da Integração” com métricas: taxa de sucesso 24h, latência média (p50/p95), fila de retentativas pendentes, últimos 20 erros com stack trace.

Testes de caos: valide antes de ir para produção

Simule: CRM offline por 30min (webhooks ficam na fila de retentativa), payload com campo obrigatório faltando (retorne 400 com detalhe), duplicidade de event_id (idempotência ignora), timeout de 60s no WordPress (Action Scheduler processa assíncrono). Use PHPUnit + WP CLI para rodar suíte automatizada no pipeline CI/CD. Documente cada cenário no README do repositório da integração.

Próximos passos para escalar

Com a base sólida, adicione: roteamento inteligente por geolocalização (CEP → equipe mais próxima), previsão de demanda baseada em histórico sazonal, portal de autoagendamento com calendário sincronizado em tempo real, integração com cuidados com caixa de gordura no município de São Paulo para upsell automatizado. Cada camada nova segue o mesmo padrão: contrato de API versionado, testes de contrato (Pact), observabilidade nativa.

A integração bem-sucedida não é um projeto com fim — é um produto interno que evolui com a operação. Comece pequeno, meça tudo, automatize a recuperação de falhas e documente para que qualquer dev da equipe possa dar manutenção daqui a seis meses. O WordPress, quando bem arquitetado, vira hub confiável de dados operacionais, não apenas CMS de conteúdo.

Para aprofundar em formulários acessíveis que alimentam esse CRM, veja Acessibilidade WCAG em formulários de orçamento no centro de São Paulo. Se o foco é converter mais leads orgânicos, Analytics de conversão para leads de desentupimento no Mandaqui mostra como mensurar. E para estruturar a área logada do cliente, Área do cliente para histórico de manutenções em Moema detalha a implementação.

Checklist prático

Perguntas frequentes