Manual Completo do
TrendZap

O TrendZap é a plataforma de atendimento e automação WhatsApp da TrendBrands. Permite que múltiplos agentes atendam pela mesma conta do WhatsApp, com roteamento inteligente por filas, automação visual via FlowBuilder e integração nativa com o ecossistema Trend (ERP, POS, TrendFood, TrendPay).

Acessando a plataforma

Acesse trendzap.com.br e entre com seu e-mail e senha cadastrados. Na primeira vez, utilize as credenciais enviadas pelo administrador da sua conta.

Configurações de perfil

O TrendZap possui quatro perfis de acesso. O controle de páginas pode ser herdado do perfil ou personalizado por usuário em Configurações → Usuários → Permissões de Página.

Criando um novo usuário

A caixa de entrada é o coração do atendimento. Exibe todas as conversas em andamento, pendentes e resolvidas, com filtros inteligentes para organizar o fluxo de trabalho.

Abas de status

Ações disponíveis em cada conversa

• Enviar texto, imagem, vídeo, áudio, documento e localização
• Gravar áudio diretamente pela plataforma (push-to-talk)
• Adicionar notas internas visíveis apenas para agentes (não enviadas ao cliente)
• Transferir a conversa para outro agente ou fila
• Resolver (encerrar) o atendimento com 1 clique
• Reabrir atendimento encerrado
• Aplicar etiquetas coloridas
• Agendar mensagem futura
• Ver histórico completo do contato
• Iniciar chat interno com outro agente sobre o caso
• Encaminhar mensagem para outro atendimento

Filtros da caixa de entrada

As filas organizam o roteamento dos clientes para os departamentos corretos. Cada fila pode ter mensagem de boas-vindas própria, horário de funcionamento, cor de identificação e agentes exclusivos.

Configurando uma fila

Tipos de roteamento

O módulo de contatos centraliza todos os números que já interagiram com seu WhatsApp, com histórico completo de atendimentos, etiquetas e campos personalizados.

Informações do contato

Importação de contatos

Importe sua base via planilha CSV. O arquivo deve conter, no mínimo, as colunas name e number.

name,number,email
João Silva,5516999998888,joao@email.com
Maria Costa,5511988887777,maria@empresa.com

As etiquetas permitem categorizar e segmentar conversas e contatos para facilitar filtros, relatórios e campanhas direcionadas.

Exemplos de uso

Criando etiquetas

Acesse Configurações → Etiquetas → Nova Etiqueta. Defina o nome e escolha uma cor. As etiquetas ficam disponíveis para todos os agentes da conta.

O módulo Kanban transforma conversas em cards visuais distribuídos por etapas de um funil. Ideal para equipes comerciais que precisam acompanhar o pipeline de negociações.

Como funciona

O FlowBuilder é o construtor visual de automações do TrendZap. Crie chatbots completos, menus interativos e jornadas de atendimento arrastando e soltando componentes no canvas — sem nenhuma linha de código.

Interface do editor

1 Essenciais

Componentes estruturais que todo fluxo precisa. Definem onde o fluxo começa, como aguardar respostas e como encaminhá-las para humanos.

2 Adicionar Conteúdo ao Fluxo

Componentes que enviam conteúdo ao cliente: textos, mídias, menus e intervalos de tempo.

3 Interações

Componentes que capturam e processam informações fornecidas pelo cliente durante o fluxo.

4 Integrações

Componentes que conectam o fluxo a sistemas externos, IAs e outras ferramentas do ecossistema TrendBrands.

Criando seu primeiro fluxo

As Tags do Kanban são etiquetas específicas para organizar e categorizar os cards dentro do funil de vendas. Diferem das etiquetas de conversas — são voltadas exclusivamente para o pipeline comercial.

Como acessar

Menu lateral → Kanban → Tags do Kanban. Aqui você cria, edita e exclui as tags disponíveis para uso nos cards do Kanban.

Diferença entre etiquetas e tags do Kanban

O módulo de IA Workflows permite criar fluxos de automação avançados que combinam inteligência artificial com ações do sistema. Diferente do FlowBuilder (orientado a conversas), o IA Workflows é orientado a processos e tarefas automatizadas.

Casos de uso

Como acessar

Menu lateral → Automação → IA Workflows. Para criar um novo workflow, clique em "Novo Workflow", defina o gatilho, as ações de IA e as ações de sistema resultantes.

O módulo de Consultas permite realizar pesquisas em bases de dados externas diretamente pela plataforma TrendZap, sem precisar sair do sistema. Disponível conforme o plano contratado.

Módulos disponíveis

Consulte informações veiculares completas pela placa. Acesse em Consultas → Veículos.

Consulte dados cadastrais de pessoas físicas e jurídicas. Acesse em Consultas → Dados.

Consulte a situação de crédito de CPF ou CNPJ em quatro bureaus diferentes. Acesse em Consultas → Dívidas e Crédito.

Consulte processos judiciais e restrições legais em bases públicas nacionais. Acesse em Consultas → Jurídico.

Respostas rápidas são mensagens pré-salvas que os agentes podem inserir na conversa com um atalho de teclado. Economizam tempo e garantem padronização no atendimento.

Como criar

Como usar

Na caixa de digitação da conversa, digite / seguido da palavra-chave. Uma lista de sugestões aparecerá. Pressione Enter para inserir a resposta.

O módulo de campanhas permite enviar mensagens para grupos de contatos de forma agendada e personalizada, com controle de intervalo entre envios para evitar bloqueios.

Criando uma campanha

Status da campanha

Programe o envio de mensagens individuais para datas e horários futuros. Útil para lembretes, follow-ups e mensagens de aniversário.

Criando um agendamento

Também é possível gerenciar todos os agendamentos em Menu → Agendamentos, onde você visualiza, edita ou cancela mensagens futuras de toda a equipe (apenas administradores).

Cada "conexão" representa um número de WhatsApp vinculado à plataforma. O TrendZap suporta múltiplas conexões simultaneamente — ideal para empresas com vários números departamentais.

Conectando um número

Status das conexões

OpenAI (ChatGPT)

Conecte o TrendZap ao ChatGPT para responder perguntas dos clientes automaticamente usando inteligência artificial.

Typebot

Integre com o Typebot para criar fluxos de conversa mais elaborados com lógica condicional avançada.

N8N e Webhooks

Conecte o TrendZap a qualquer sistema externo via N8N ou webhooks customizados. Casos de uso comuns:

• Notificar o ERP quando um novo lead chega pelo WhatsApp
• Buscar status de pedido no TrendFood e responder ao cliente automaticamente
• Criar ticket no sistema de suporte quando cliente relata problema
• Sincronizar contatos do WhatsApp com o CRM externo
• Enviar link de pagamento TrendPay quando cliente confirma pedido

DialogFlow (Google)

Para projetos de NLP (processamento de linguagem natural) avançados, conecte ao DialogFlow para reconhecimento de intenções e entidades. Configure em Configurações → Integrações → DialogFlow.

Configuração de Webhook genérico

{
  "event": "message",
  "contactName": "João Silva",
  "contactNumber": "5516999998888",
  "message": "Quero fazer um pedido",
  "queueName": "Vendas",
  "agentName": "Maria"
}

Painel de Controle (Dashboard)

O dashboard em tempo real exibe os principais indicadores de atendimento:

Relatórios disponíveis

Todos os relatórios podem ser exportados em formato CSV para análise em planilhas.

Mensagens automáticas

Horário de funcionamento

Configure em Configurações → Horário de Funcionamento. Defina os dias da semana e horários de início e fim para cada dia. É possível ter horários distintos por fila.

Notificações

• Notificação sonora para novas mensagens (configurável por agente)
• Notificação do navegador (requer permissão)
• Notificação de nova conversa na fila
• Alerta quando uma conversa fica sem resposta por X minutos

O TrendZap expõe uma API REST completa para integração com sistemas externos. A base da URL de produção é https://www.trendzap.com.br/api. Toda requisição requer autenticação via Bearer Token no cabeçalho.

Índice de endpoints

1. Autenticação

POST /api/auth/login
Content-Type: application/json

{
  "email": "usuario@empresa.com",
  "password": "suasenha"
}

// Resposta
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": { "id": 1, "name": "João", "profile": "admin" }
}

2. Tickets (Atendimentos)

GET /api/ticket/list?status=open&queueId=2&page=1
Authorization: Bearer {token}

// Parâmetros opcionais
// status: open | closed | pending
// queueId: ID da fila
// userId: ID do agente
// page: número da página (paginação)

POST /api/ticket/create
Authorization: Bearer {token}
Content-Type: application/json

{
  "contactId": 42,
  "queueId": 3,
  "userId": 5,
  "status": "open"
}

3. Mensagens

GET /api/message/list?ticketId=123&pageNumber=1
Authorization: Bearer {token}

POST /api/message/send
Authorization: Bearer {token}
Content-Type: application/json

{
  "number": "5516999998888",
  "body": "Olá {{name}}, seu pedido foi confirmado!",
  "mediaUrl": "https://exemplo.com/comprovante.pdf"
}

// Campos
// number  : número com DDI+DDD (obrigatório)
// body    : texto da mensagem (obrigatório se sem mídia)
// mediaUrl: URL pública de imagem, PDF, áudio ou vídeo (opcional)

4. Contatos

GET /api/contact/list?searchParam=João&pageNumber=1
Authorization: Bearer {token}

POST /api/contact/create
Authorization: Bearer {token}
Content-Type: application/json

{
  "name": "Maria Costa",
  "number": "5511988887777",
  "email": "maria@empresa.com",
  "companyName": "Empresa Ltda"
}

5. Faturas

GET /api/invoice/list?status=pending&page=1
Authorization: Bearer {token}

POST /api/invoice/create
Authorization: Bearer {token}
Content-Type: application/json

{
  "contactId": 42,
  "value": 150.00,
  "dueDate": "2025-07-30",
  "description": "Mensalidade TrendZap — Julho/2025"
}

6. Webhook de Entrada

POST /api/webhook
Authorization: Bearer {token}
Content-Type: application/json

{
  "url": "https://meusite.com.br/webhook/trendzap",
  "events": ["message", "ticket.created", "ticket.closed"]
}

// Eventos disponíveis:
// message           — nova mensagem recebida de cliente
// ticket.created    — atendimento aberto
// ticket.closed     — atendimento encerrado
// ticket.transferred— conversa transferida
// contact.created   — novo contato criado

Payload de saída (exemplo: evento message)

{
  "event": "message",
  "contactName": "João Silva",
  "contactNumber": "5516999998888",
  "message": "Quero fazer um pedido",
  "ticketId": 87,
  "queueName": "Vendas",
  "agentName": "Maria"
}

7. Sessões do WhatsApp

POST /api/whatsapp/session
Authorization: Bearer {token}
Content-Type: application/json

{
  "whatsappId": 1,
  "action": "generateQR"   // generateQR | disconnect | status
}

// Resposta (generateQR)
{
  "qrCode": "data:image/png;base64,iVBOR...",
  "status": "qrcode"
}

8. Agendamentos

Base: https://www.trendzap.com.br/schedules

GET https://www.trendzap.com.br/schedules?page=1&status=pending
Authorization: Bearer {token}

POST https://www.trendzap.com.br/schedules
Authorization: Bearer {token}
Content-Type: application/json

{
  "contactId": 42,
  "whatsappId": 1,
  "body": "Lembrete: seu compromisso é amanhã às 10h!",
  "sendAt": "2025-07-15T09:00:00-03:00"
}

PUT https://www.trendzap.com.br/schedules/1
Authorization: Bearer {token}
Content-Type: application/json

{
  "body": "Texto atualizado da mensagem",
  "sendAt": "2025-07-16T10:00:00-03:00"
}

GET https://www.trendzap.com.br/schedules/1
Authorization: Bearer {token}

DELETE https://www.trendzap.com.br/schedules/1
Authorization: Bearer {token}

POST https://www.trendzap.com.br/schedules/1/media-upload
Authorization: Bearer {token}
Content-Type: multipart/form-data

// Campo: "file" — arquivo binário (jpg, png, pdf, mp3, mp4)

DELETE https://www.trendzap.com.br/schedules/1/media-upload
Authorization: Bearer {token}

Exemplo completo em PHP

Padrão de chamada PHP aplicável a qualquer endpoint da API:

<?php
$baseUrl = 'https://www.trendzap.com.br/api';
$token   = '{token_de_autenticacao}';

$headers = [
  'Content-Type: application/json',
  'Authorization: Bearer ' . $token
];

// Exemplo: enviar mensagem
$payload = json_encode([
  'number' => '5516999998888',
  'body'   => 'Olá! Seu pedido foi confirmado.'
]);

$options = [
  'http' => [
    'method'  => 'POST',
    'header'  => implode("\r\n", $headers),
    'content' => $payload
  ]
];

$context  = stream_context_create($options);
$response = file_get_contents($baseUrl . '/message/send', false, $context);
$data     = json_decode($response, true);

echo $data['id']; // ID da mensagem enviada

O Painel é a tela inicial após o login. Exibe resumo do plano contratado e indicadores de desempenho em tempo real.

Resumo do plano

KPIs principais

Visualizações

O TrendZap pode monitorar e responder mensagens de grupos do WhatsApp vinculados ao número conectado. O módulo de Grupos aparece no menu Inbox → Grupos quando a opção está habilitada.

Como habilitar grupos

Registra e monitora todas as chamadas de voz recebidas via WhatsApp, com métricas e filtros para análise.

Filtros disponíveis

Gerencia o ciclo completo de relacionamento — do primeiro contato ao pós-venda, com ordens de serviço e funil de negócios.

Status das Ordens de Serviço

Cada usuário/profissional pode ter uma agenda com compromissos visualizados em calendário mensal. Ideal para clínicas, salões, consultórios e qualquer negócio com agendamento.

Criando uma Agenda

Status dos compromissos

Configure prompts de inteligência artificial que respondem automaticamente aos clientes, com suporte a OpenAI e Google Gemini.

Provedores suportados

Parâmetros de configuração

Ferramentas disponíveis para o Agente

O módulo financeiro gerencia as cobranças que o usuário do TrendZap emite para os seus próprios clientes — faturas, contas a pagar, receitas e pagamentos.

Campos do formulário Nova Fatura

Outros módulos financeiros

Gerencie projetos com tarefas, prazos e faturamento — integrado ao CRM e ao atendimento.

Produtos e serviços com controle de estoque, variações e categorias. Produtos podem ser exibidos em fluxos via nó Lista de Produtos.

O TrendZap suporta cinco tipos de canais de atendimento. Gerencie em Configurações → Canais.

Conectando o WhatsApp (QR Code)

O programa de afiliados permite que clientes do TrendZap indiquem o TrendZap para outras empresas e ganhem comissões quando essas empresas assinarem o serviço.

Painel do Afiliado

Link de indicação

Cada afiliado recebe um código único (ex.: B7D232) e a URL completa:

https://app.trendzap.com.br/cadastro?aff=B7D232

O link rastreia cliques, cadastros e conversões individualmente.

Regras do programa

Além da API interna, o TrendZap expõe uma API externa com autenticação por token de empresa para integração com sistemas terceiros.

Módulos disponíveis

Webhooks — eventos disponíveis

O QR Code expirou. O que fazer?

Vá em Configurações → Conexões, clique no número desconectado e depois em "Reconectar". Um novo QR Code será gerado. Escaneie com o WhatsApp em até 60 segundos.

O cliente não recebe as mensagens automáticas. Por quê?

Verifique: (1) a conexão WhatsApp está com status "Conectado"; (2) o FlowBuilder está publicado e vinculado à conexão; (3) o número não está bloqueado pelo cliente.

Como transferir uma conversa para outro agente?

Dentro da conversa, clique no ícone de transferência (seta dupla) na barra superior. Selecione o agente ou a fila de destino e confirme.

Posso ter mais de um número conectado?

Sim. O TrendZap suporta múltiplas conexões simultâneas. Cada número pode ter seu próprio FlowBuilder, filas e agentes.

Como ativar a transcrição de áudio?

Configurações → Integrações → OpenAI. Com a API Key configurada, ative a opção "Transcrever áudios recebidos". Todos os áudios enviados pelos clientes serão transcritos automaticamente.

O FlowBuilder pode iniciar uma conversa sem o cliente ter enviado mensagem?

Sim. Use o endpoint POST /api/messages/flowbuilderStart com o número do cliente e o ID da fila. O fluxo será disparado de forma proativa.

Como exportar o histórico de uma conversa?

Dentro da conversa, clique nos três pontos (⋮) no canto superior direito → "Exportar histórico". Um arquivo PDF ou TXT será gerado.

Como integrar o TrendZap ao Trend ERP?

Configure no ERP o webhook de saída apontando para a API do TrendZap. Cada evento do ERP (novo pedido, OS pronto, vencimento de cobrança) dispara uma mensagem automática ao cliente via WhatsApp. Consulte a equipe TrendBrands para o guia de integração completo.

Qual o limite de mensagens por dia?

Não há limite imposto pela plataforma, mas o WhatsApp pode bloquear números que disparem volume excessivo para contatos que não salvaram o número. Para campanhas em massa, respeite intervalos mínimos entre envios e envie apenas para quem já interagiu com sua conta.