CRM LP

Central de Ajuda

Guias de configuração para todos os canais e integrações

Widget de Chat para Sites

Adicione um chat de atendimento em qualquer site. As mensagens chegam na Caixa de Entrada junto com WhatsApp e Instagram.

Criar o Canal Webchat

Vá em Canais e clique em Nova Instância. Selecione o tipo webchat (ou crie via API):

POST /api/channels
{
  "type": "webchat",
  "name": "Chat do Site Principal",
  "welcomeMessage": "Olá! Como posso ajudar?",
  "aiEnabled": true
}

Anote o ID do canal retornado (ex: 5).

Instalar no site do cliente

Cole este script antes do </body> no HTML do site:

<script
  src="https://SEU-DOMINIO/widget.js"
  data-api="https://SEU-DOMINIO"
  data-channel="ID_DO_CANAL"
  data-color="#465FFF"
  data-title="Suporte"
  data-subtitle="Estamos online"
  data-position="right"
></script>

Substitua SEU-DOMINIO pelo endereço do CRM (ex: http://24.144.86.152) e ID_DO_CANAL pelo ID do canal webchat criado.

Parâmetros disponíveis

Atributo	Obrigatório	Descrição
`data-api`	Sim	URL base do CRM
`data-channel`	Sim	ID do canal webchat
`data-color`	Não	Cor principal do widget (hex). Padrão: `#465FFF`
`data-title`	Não	Título no header. Padrão: "Chat"
`data-subtitle`	Não	Subtítulo. Padrão: "Estamos online"
`data-position`	Não	`right` ou `left`. Padrão: `right`

Como funciona

O visitante abre o chat e digita seu nome
Cada mensagem é enviada para a API do CRM via POST /api/widget
Se a IA estiver ativa, responde automaticamente
As mensagens aparecem na Caixa de Entrada com o ícone do canal webchat
O atendente pode assumir a conversa clicando em "Assumir Conversa"
O widget faz polling a cada 3s para receber respostas (da IA ou do humano)

Integração WhatsApp

Conecte números de WhatsApp via QR Code para receber e enviar mensagens.

Criar o Canal

Vá em Canais → Nova Instância → selecione WhatsApp → defina um nome.

Conectar via QR Code

Clique em Conectar. Um QR Code aparecerá no card. Abra o WhatsApp no celular → Dispositivos Conectados → Conectar Dispositivo → escaneie o QR.

O servidor precisa manter a conexão ativa. Se o servidor reiniciar, reconecte o QR.

Configurar IA

Clique em Config na instância → ative o Agente de IA → escreva o prompt de treinamento com informações da empresa.

Takeover humano

Na Caixa de Entrada, clique em "Assumir Conversa" para parar a IA e responder manualmente. Clique em "Devolver p/ IA" para reativar.

Integração Instagram

Receba mensagens do Instagram Direct na Caixa de Entrada.

Criar App no Meta Developer Portal

Acesse developers.facebook.com → Criar App → Tipo: Business
Adicione o produto Instagram Messaging (ou Messenger)
Na seção Instagram Settings, conecte sua conta do Instagram Business
Gere um Access Token com permissão instagram_manage_messages
Anote o Instagram User ID (ou Page ID)

Criar o Canal no CRM

Vá em Canais → Nova Instância → selecione Instagram

Page/IG User ID: o ID copiado do Meta Developer Portal
Access Token: o token gerado

Configurar Webhook no Meta

No Meta Developer Portal → Webhooks → Adicionar:

Callback URL: https://SEU-DOMINIO/api/webhook/instagram
Verify Token: crm-lp-instagram-verify

Assine os campos: messages, messaging_postbacks

O webhook precisa ser HTTPS. Configure um domínio com SSL ou use um serviço como ngrok para testes.

Testar

Envie uma mensagem para o Instagram Business conectado. Ela deve aparecer na Caixa de Entrada com o ícone rosa do Instagram.

Plugin WordPress

Capture leads de formulários WordPress automaticamente.

Instalar o plugin

Faça upload da pasta crm-lp-wordpress-plugin para wp-content/plugins/ e ative.

Configurar

Vá em Configurações → CRM LP no WordPress:

URL da API: https://SEU-DOMINIO/api/leads
API Key: a chave do .env do CRM
Source: identificador do site (ex: site-principal)

Mapear campos

Mapeie os campos do formulário (CF7, WPForms, Elementor, Gravity Forms) para os campos do CRM. Campos personalizados vão para metadata.

Rastreamento de WhatsApp

Links de WhatsApp no site são rastreados automaticamente. Cada clique é registrado na aba WhatsApp dos Leads.

API REST

Use a API para integrar com qualquer sistema externo.

Autenticação

Envie o header X-API-Key com a chave configurada no .env:

curl -X GET https://SEU-DOMINIO/api/leads \
  -H "X-API-Key: sua-chave-aqui"

Endpoints

Método	Rota	Descrição
`GET`	`/api/leads`	Listar leads
`POST`	`/api/leads`	Criar lead
`GET`	`/api/channels`	Listar canais
`POST`	`/api/channels`	Criar canal
`GET`	`/api/inbox`	Listar conversas
`GET`	`/api/inbox/:id`	Mensagens de uma conversa
`POST`	`/api/inbox/:id/send`	Enviar mensagem
`POST`	`/api/widget`	Widget: enviar mensagem