# Agilize Docs para IA Este arquivo é a versão compacta, canônica e legível por IA da documentação pública da Agilize. Ele combina guias locais versionados, páginas geradas a partir do OpenAPI e links para a referência interativa. Última geração: 2026-06-15T08:46:01.910Z ## Como usar na prática - Para responder dúvidas de usuários finais, priorize as seções "Guias de produto" e "Detalhes dos guias". - Para integrações, priorize "API Agilize", "Autenticação", "Endpoints por assunto" e o OpenAPI JSON. - Para exemplos executáveis, use a página individual do endpoint ou a referência interativa com Scalar. - Para testes via navegador, prefira o proxy server-side da documentação quando disponível; chamadas diretas podem depender de CORS. - Nunca invente parâmetros, permissões, limites, status ou payloads. Se o dado não estiver neste arquivo, consulte o OpenAPI JSON. - A autenticação técnica usa o header x-api-key, salvo indicação específica do endpoint. ## Links canônicos - Documentação humana: https://agilize.app/docs - Leitura para IA: https://agilize.app/docs/llms.txt - Referência interativa da API: https://agilize.app/docs/desenvolvedores/referencia-tecnica/referencia-api - OpenAPI JSON atual: https://agilize.app/api/docs/openapi/agilize - Fallback OpenAPI versionado: https://agilize.app/openapi/agilize-v1.json ## API Agilize - Título: Agilize.app Omni Channel API - Versão da API: 0.0.12 - Versão OpenAPI: 3.1.0 - Base URL: https://api.agilize.app - Autenticação principal: header x-api-key - Total de endpoints mapeados: 95 ### Cabeçalhos básicos ```http Accept: application/json x-api-key: SUA_CHAVE_API ``` ## Índice de guias - https://agilize.app/docs: Documentação Agilize - Guias oficiais para operação, configuração e desenvolvimento na plataforma Agilize. - https://agilize.app/docs/primeiros-passos: Introdução - Visão inicial da plataforma, dos conceitos principais e do caminho recomendado para começar. - https://agilize.app/docs/primeiros-passos/visao-geral: Visão geral da Agilize - Entenda como a Agilize conecta canais, Flow, atendimento, CRM, automações, tarefas, usuários e permissões em uma operação única. - https://agilize.app/docs/usuarios: Operação - Guias de uso para atendimento, CRM, oportunidades, automações e rotina diária. - https://agilize.app/docs/usuarios/flow-e-atendimento/atendimento-omnichannel: Atendimento omnichannel - Como atender conversas de diferentes canais pela Agilize, mantendo responsável, histórico, contexto e continuidade operacional. - https://agilize.app/docs/usuarios/crm-relacionamento/crm-e-oportunidades: CRM e oportunidades - Como criar, qualificar, movimentar e acompanhar oportunidades no CRM da Agilize usando funis, etapas, responsáveis, valor, origem, score e próximas ações. - https://agilize.app/docs/usuarios/flow-e-atendimento/automacoes-e-ia: Automações e IA - Como usar automações, fluxos e agentes de IA no dia a dia sem perder governança, contexto e controle operacional. - https://agilize.app/docs/configuracao: Configuração - Guias para preparar canais, funis, usuários, permissões e regras da plataforma. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/canais-e-integracoes: Canais e integrações - Como conectar, configurar, testar e governar canais de atendimento e integrações externas na Agilize. - https://agilize.app/docs/configuracao/crm-dados/funis-etapas-e-origens: Funis, etapas e origens - Como configurar funis, etapas e origens para organizar oportunidades, automações, relatórios e rotinas comerciais na Agilize. - https://agilize.app/docs/configuracao/acessos-seguranca/usuarios-equipes-e-permissoes: Usuários, equipes e permissões - Como configurar usuários, funções, equipes de distribuição, equipes organizacionais e escopo de dados na Agilize com segurança operacional. - https://agilize.app/docs/configuracao/crm-dados/tags-automacoes-e-regras: Tags e regras - Padronize classificações e regras de uso para manter a operação rastreável e consistente. - https://agilize.app/docs/desenvolvedores: Desenvolvedores - Guias técnicos para autenticação, webhooks e integração com a API Agilize. - https://agilize.app/docs/desenvolvedores/guias-integracao/introducao: Introdução à API - Visão geral para integrar sistemas externos à API Agilize. - https://agilize.app/docs/desenvolvedores/guias-integracao/autenticacao: Autenticação - Como autenticar chamadas na API Agilize usando chave de acesso. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/referencia-api: Referência da API - Documentação interativa dos endpoints da API Agilize. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks: Webhooks técnicos - Eventos de webhook da Agilize organizados por assunto e serviço. - https://agilize.app/docs/configuracao/acessos-seguranca: Acessos e segurança - Guias para usuários, equipes, permissões, governança de acesso e segurança operacional. - https://agilize.app/docs/configuracao/acessos-seguranca/escopo-dados-equipe-organizacional: Escopo de dados por equipe organizacional - Como usar equipes organizacionais, supervisores e registros próprios para controlar acesso a oportunidades, contatos, relatórios e dados operacionais. - https://agilize.app/docs/configuracao/acessos-seguranca/seguranca-operacional: Segurança operacional - Como revisar acessos, permissões, equipes, canais, automações e integrações para reduzir risco operacional. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes: Canais, WhatsApp e integrações - Guias para conectar canais, cadastrar modelos, organizar listas e preparar transmissões. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/ativar-eventos-instagram-conta-integrada: Ativar eventos em uma conta Instagram já integrada - Como habilitar comentários, lives, Stories e reações em uma Página Instagram já conectada à Agilize, sem perder o Direct atual. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/cadastro-de-modelos-de-mensagem-whatsapp: Cadastro de modelos de mensagem WhatsApp - Como criar, revisar, aprovar e manter modelos de WhatsApp para retomadas, transmissões, fluxos, automações e follow-ups na Agilize. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/integrar-instagram-nova-conta: Integrar Instagram pela primeira vez - Passo a passo para conectar uma nova conta do Instagram à Agilize, escolher eventos iniciais e validar Direct, Stories, comentários e lives. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/listas-de-transmissao: Listas de transmissão - Como criar, alimentar, revisar e manter listas de transmissão para WhatsApp, Voz, automações e campanhas segmentadas. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/modelos-mensagens-respostas-rapidas: Modelos, mensagens e respostas rápidas - Como organizar modelos WhatsApp, atalhos, categorias e padrões de comunicação para atendimento e automações. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/transmissao-em-massa-voz: Configuração de transmissão em massa por Voz - Como configurar, iniciar e acompanhar disparos em massa por ligação usando listas, fluxo de chamada, horário permitido e chamadas simultâneas. - https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/transmissao-em-massa-whatsapp: Configuração de transmissão em massa por WhatsApp - Como configurar, iniciar e acompanhar disparos em massa por WhatsApp usando listas, modelos aprovados, variáveis e rastreamento de respostas. - https://agilize.app/docs/configuracao/crm-dados: CRM, funis e dados - Guias de funis, etapas, origens, campos obrigatórios, qualidade de dados e tags. - https://agilize.app/docs/configuracao/crm-dados/campos-e-dados-obrigatorios: Campos e dados obrigatórios - Como definir dados mínimos e campos obrigatórios para contatos, empresas, oportunidades e suporte sem prejudicar a operação diária. - https://agilize.app/docs/configuracao/crm-dados/importar-leads-csv: Importar leads por CSV - Como importar oportunidades em lote na Agilize, enviando um CSV, mapeando colunas, escolhendo funil, etapa, origem, tags, distribuição e acompanhando o resultado do processamento. - https://agilize.app/docs/configuracao/crm-dados/qualidade-dados-prevencao-duplicidade: Qualidade de dados e prevenção de duplicidade - Como padronizar contatos, empresas, oportunidades, telefones, e-mails, campos obrigatórios e regras de duplicidade. - https://agilize.app/docs/configuracao/fluxos-automacoes: Fluxos e automações - Guias práticos de fluxos do bot, automações de CRM, cadências e governança. - https://agilize.app/docs/configuracao/fluxos-automacoes/agentes-ia-fluxos-bot: Agentes de IA em fluxos do bot - Como configurar conta de provedor, agente de IA, prompt, variáveis de saída, intenções e conexão com nodes em fluxos do bot. - https://agilize.app/docs/configuracao/fluxos-automacoes/automacoes-administrativas: Automações administrativas - Como governar criação, testes, ativação, pausa, ownership e auditoria de automações na Agilize. - https://agilize.app/docs/configuracao/fluxos-automacoes/automacoes-de-crm: Automações de CRM - Como criar, testar, ativar, pausar e auditar automações de CRM para oportunidades, contatos, empresas, tarefas, tags, responsáveis e mensagens. - https://agilize.app/docs/configuracao/fluxos-automacoes/automacoes-sociais-instagram: Automações sociais para comentários do Instagram - Guia completo para criar automações sociais no Instagram, configurar comentários, resposta pública, private reply, prioridade, escopo e fluxo pós-Direct. - https://agilize.app/docs/configuracao/fluxos-automacoes/cadencias-envio-follow-up-automacao: Cadências de envio e follow-up por automação - Como montar cadências de contato no CRM usando condições, mensagens, tarefas, esperas e revalidações antes de cada nova ação. - https://agilize.app/docs/configuracao/fluxos-automacoes/cenarios-comuns-de-fluxos-do-bot: Cenários comuns de fluxos do bot - Modelos práticos para montar entrada de atendimento, qualificação, geração de oportunidade, distribuição, transferência e encerramento com avaliação. - https://agilize.app/docs/configuracao/fluxos-automacoes/fluxos-do-bot: Fluxos do bot - Como usar fluxos do bot para automatizar entrada, qualificação, distribuição, geração de registros e encerramento de conversas. - https://agilize.app/docs/configuracao/fluxos-automacoes/guia-geral-de-fluxos-do-bot: Guia geral de fluxos do bot - Como planejar, desenhar, testar, publicar e manter fluxos do bot antes de colocar a automação em produção. - https://agilize.app/docs/configuracao/implantacao-go-live: Implantação e go-live - Guias para preparar a conta, validar configuração, liberar operação e resolver incidentes iniciais. - https://agilize.app/docs/configuracao/implantacao-go-live/checklist-go-live: Checklist de go-live - Lista de validação para liberar a Agilize em produção com canais, usuários, filas, CRM, automações, relatórios e segurança revisados. - https://agilize.app/docs/configuracao/implantacao-go-live/configuracao-inicial-da-conta: Configuração inicial da conta - Roteiro recomendado para preparar usuários, equipes, canais, funis, origens, tags, automações e permissões antes de iniciar a operação na Agilize. - https://agilize.app/docs/configuracao/implantacao-go-live/troubleshooting-operacional: Troubleshooting operacional - Como diagnosticar problemas comuns em mensagens, canais, Flow, CRM, automações, telefonia, relatórios e permissões. - https://agilize.app/docs/configuracao/referencias: Referências de configuração - Consulta detalhada de nodes de fluxos do bot, automações de CRM e webhooks. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm: Nodes de automação de CRM - Referência dos nodes usados para criar automações de CRM, tarefas, atribuições, mensagens, webhooks e mudanças de etapa. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/adicionar-alterar-tags: Adicionar / Alterar Tags - Adiciona novas tags ou limpa as tags da entidade em processamento. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/aguardar-prazo: Aguardar Prazo - Pausa o fluxo por minutos, horas ou dias antes de continuar. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/alterar-usuario-retorno-de-chat: Alterar Usuário Retorno de Chat - Define ou limpa o usuário preferencial de retorno para a sala de chat ligada à entidade. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/atribuir-distribuir-usuario: Atribuir/Distribuir Usuário - Atribui a entidade a um usuário específico ou distribui por equipe. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/avaliar-condicao: Avaliar Condição - Avalia uma condição sobre a entidade e segue pelo resultado (verdadeiro ou falso). - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/concluir-conversa: Concluir Conversa - Conclui as salas de conversa associadas ainda abertas para a entidade do fluxo. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/condicao-inicial: Condição Inicial - Define a condição inicial que dispara o restante do fluxo. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/criar-item-pipeline: Criar Item Pipeline - Cria um item em um pipeline (com campos, vínculos e atribuição). - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/criar-tarefa-atividade: Criar Tarefa/Atividade - Cria uma atividade vinculada à entidade (com distribuição, data e checklist). - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/enviar-conversoes: Enviar Conversões - Envia eventos de conversão (Meta CAPI e Google Enhanced Conversions) com deduplicação por registro. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/enviar-sms: Enviar SMS - Envia SMS e registra timeline (inclui vinculação ao pipeline quando aplicável). - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/enviar-webhook-http: Enviar Webhook HTTP - Envia, de forma assíncrona, os dados da entidade para uma URL (webhook). - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/gerar-entidade: Gerar Entidade - Cria ou atualiza contato, empresa ou oportunidade no CRM. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/lead-ganhou-ou-perdeu: Lead Ganhou ou Perdeu - Marca uma oportunidade como ganha ou perdida. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/mensagem-whatsapp-c-fluxo-template: Mensagem WhatsApp c/ Fluxo (Template) - Envia template do WhatsApp e cria rotas pelos botões do template. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/mensagem-whatsapp-template: Mensagem WhatsApp (Template) - Envia um template de WhatsApp para a entidade considerando seus dados. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/mover-etapa-pipeline: Mover Etapa Pipeline - Move um item de pipeline para outra etapa (respeita validações). - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/operacao-em-lista-de-transmissao: Operação em Lista de Transmissão - Adiciona ou remove a entidade de uma lista de transmissão. - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/setar-funil-etapa-lead: Setar Funil/Etapa Lead - Altera o funil e/ou a etapa de uma oportunidade (lead). - https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/vincular-sala-pipeline: Vincular Sala (Pipeline) - Vincula uma sala (Messenger) a um item do pipeline e cria contexto da sala para exibição. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot: Nodes de fluxos do bot - Referência dos nodes usados nos fluxos do bot para mensagens, condições, transferências, IA, geração de entidades e encerramento. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/adicionar-alterar-tags: Adicionar / Alterar Tags - Adiciona novas tags à sala de conversa ou limpa as atuais. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/adicionar-tags-no-detalhamento: Adicionar Tags no Detalhamento - Adiciona ou limpa tags no detalhamento da conversa atual. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/agente-de-inteligencia-artificial: Agente de Inteligência Artificial - Encaminha mensagens para um agente de IA e segue a intenção identificada. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/ativar-debug-inspecao: Ativar Debug / Inspeção - Ativa o modo Debug / Inspeção do fluxo para uma sala específica. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/ativar-fluxo-de-encerramento: Ativar Fluxo de Encerramento - Habilita um fluxo específico para ser executado no encerramento do atendimento. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/chamada-em-api-externa: Chamada em API Externa - Executa um método de integração e segue pela rota de sucesso, falha ou limite. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/coletar-pesquisa-de-satisfacao: Coletar Pesquisa de Satisfação - Solicita uma nota de satisfação do cliente e registra a resposta. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/condicionais-por-tag: Condicionais por Tag - Roteia a conversa conforme tags (sala/contato/empresa/lead) por prioridade. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/condicional-conjunto-de-datas: Condicional Conjunto de Datas - Verifica se a data/hora atual está dentro de pelo menos uma das regras selecionadas. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/condicional-de-tempo: Condicional de Tempo - Direciona o fluxo conforme faixas de horário e dias da semana. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/conectar-fluxo: Conectar Fluxo - Alterna a execução para outro fluxo de bot. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destacar-fixar-variaveis: Destacar/Fixar Variáveis - Exibe e fixa variáveis importantes para o operador durante o atendimento. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destino-em-tempo-limite: Destino em Tempo Limite - Cria uma bifurcação: executar agora ou seguir para rota de tempo limite após prazo. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destino-por-conta-whatsapp: Destino por Conta WhatsApp - Roteia a conversa conforme a conta do WhatsApp integrada (número) que originou a conversa. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destino-por-origem-do-canal: Destino por Origem do Canal - Roteia a conversa conforme o tipo de canal de origem (LiveChat, WhatsApp com telefone de origem, WhatsApp sem telefone, Facebook Page, Instagram DM). - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destino-por-valor-de-variavel: Destino por Valor de Variável - Roteia o fluxo conforme o valor de uma variável (telefone, nome, e-mail ou variável do fluxo). - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/finalizar-atendimento: Finalizar Atendimento - Encerra a conversa atual e finaliza o atendimento. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/fluxo-por-textos-palavras: Fluxo por Textos/Palavras - Cria rotas a partir de palavras-chave ou expressões (regex) na mensagem. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/fluxos-por-variavel: Fluxos por Variável - Direciona o fluxo conforme o valor de uma variável. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/gerar-entidade: Gerar Entidade - Cria ou atualiza contato, empresa ou oportunidade a partir da conversa. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/gerar-lead: Gerar Lead - Cria uma oportunidade (lead) a partir da conversa em andamento. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/inicio: Início - Ponto inicial do fluxo de atendimento por chat. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-c-midia: Mensagem com Mídia - Envia uma mensagem com mídia (imagem, áudio, vídeo ou documento) e legenda opcional. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-c-opcoes: Mensagem com Opções - Envia mensagem com botões e direciona o fluxo conforme a opção escolhida. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-com-opcoes-de-variaveis: Mensagem com Opções de Variáveis - Gera botões a partir de uma lista em variável e salva a opção escolhida. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-de-template-wa: Mensagem de Template WhatsApp - Envia uma mensagem de template do WhatsApp previamente aprovado. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-simples: Mensagem Simples - Envia uma mensagem de texto simples; opcionalmente aguarda resposta. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-texto-de-variaveis: Mensagem Texto de Variáveis - Envia ao cliente o conteúdo de uma variável (texto ou lista). - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/requisicao-http-delegar: Requisição HTTP (Delegar) - Delegue o processamento do fluxo para um endpoint HTTP próprio. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/requisicao-http-webhook: Requisição HTTP (Webhook) - Envia o estado atual da conversa para uma URL (webhook) sem bloquear o fluxo. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/solicitar-informacao-textual: Solicitar Informação Textual - Solicita um texto ao cliente e salva o valor em uma variável. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/transferir-departamento: Transferir Departamento - Transfere a conversa para um departamento específico. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/transferir-departamento-em-timeout: Transferir Departamento em Timeout - Transfere a conversa para um departamento após um tempo de espera. - https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/verifica-e-transfere-usuario-preferencia: Verifica e Transfere Usuário Preferência - Transfere para usuário preferencial da sala ou do CRM. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks: Nodes de webhooks - Referência dos nodes usados em webhooks para receber payloads, criar entidades, buscar registros, mapear usuários, criar tarefas e atualizar contexto. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/alterar-campo-adicional: Alterar Campo Adicional - Atualiza campos adicionais de lead, contato ou empresa usando uma entidade salva no contexto. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/alterar-etapa-do-lead: Alterar Etapa do Lead - Altera a etapa do lead salvo no contexto do webhook. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/buscar-entidade: Buscar Entidade - Busca uma entidade do CRM e a salva no contexto para uso em nós posteriores. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/criar-tarefa-atividade: Criar Tarefa/Atividade - Cria uma atividade no CRM reaproveitando entidades e usuário já resolvidos no webhook. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/debug-inspecao-de-evento: Debug / Inspeção de Evento - Inspeciona o evento recebido (payload/contexto) e auxilia no teste do webhook. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/fluxos-por-valor: Fluxos por Valor - Direciona o fluxo conforme o valor de um campo do payload/contexto. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/gerar-entidade: Gerar Entidade - Cria contato, empresa ou oportunidade usando dados do webhook. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/inicio-do-fluxo: Início do Fluxo - Ponto inicial do fluxo de Webhook/Integração. - https://agilize.app/docs/configuracao/referencias/nodes-webhooks/mapear-usuario: Mapear Usuário - Resolve um usuário a partir de um valor do webhook, por e-mail ou de/para. - https://agilize.app/docs/configuracao/relatorios-governanca: Relatórios e governança - Guias para configurar painéis de BI, padronizar indicadores e manter permissões de edição sem misturar operação com governança. - https://agilize.app/docs/configuracao/relatorios-governanca/configurar-paineis-bi: Configurar painéis de BI - Como estruturar painéis de BI na Agilize, adicionando itens de relatório, organizando layout, período global, modo foco e rotina de revisão. - https://agilize.app/docs/configuracao/relatorios-governanca/padronizar-indicadores-operacao: Padronizar indicadores da operação - Como definir indicadores oficiais, nomes, fontes, filtros, períodos e critérios de leitura para que a operação use o BI com consistência. - https://agilize.app/docs/configuracao/relatorios-governanca/permissoes-manutencao-paineis: Permissões e manutenção de painéis - Como controlar acesso, edição, duplicação, exclusão e revisão dos painéis e itens de relatório do BI da Agilize. - https://agilize.app/docs/configuracao/rh-workforce: RH/Workforce - Guias administrativos para configurar jornada, perfis, feriados, associações e ocorrências. - https://agilize.app/docs/configuracao/rh-workforce/cadastrar-perfis-de-jornada: Cadastrar perfis de jornada - Como criar perfis de jornada no RH/Workforce, definindo horários, almoço, pausas obrigatórias, bloqueio fora do horário, tolerância e liberação excepcional. - https://agilize.app/docs/configuracao/rh-workforce/configuracao-rh-workforce: Configuração do módulo de RH/Workforce - Como estruturar jornadas, perfis, feriados, associações, motivos de status e ocorrências no módulo de RH/Workforce. - https://agilize.app/docs/configuracao/roteamento-distribuicao: Roteamento e distribuição - Guias para levar conversas, oportunidades e demandas ao time correto. - https://agilize.app/docs/configuracao/roteamento-distribuicao/regras-de-roteamento-e-distribuicao: Regras de roteamento e distribuição - Como configurar canais, departamentos, equipes, suporte, fluxos do bot e automações para direcionar demandas ao time certo. - https://agilize.app/docs/configuracao/telefonia: Telefonia - Guias de filas, ramais, URA e vínculo de fluxo de telefonia no número de entrada. - https://agilize.app/docs/configuracao/telefonia/cadastro-de-filas-telefonia: Cadastro de filas de telefonia - Como configurar filas de atendimento telefônico, estratégia de toque, ramais, música em espera, limites e destinos de exceção. - https://agilize.app/docs/configuracao/telefonia/cadastro-de-ramais: Cadastro de ramais - Como cadastrar ramais, vincular usuários, controlar senha SIP, gravação de chamadas e grupo de saída. - https://agilize.app/docs/configuracao/telefonia/cadastro-de-ura: Cadastro de URA - Como configurar menus de voz com áudio inicial, opções de teclado, tempo de espera e destinos de atendimento. - https://agilize.app/docs/configuracao/telefonia/vinculo-fluxo-telefonia-numero-entrada: Vínculo do Fluxo de Telefonia no Número de Entrada - Como definir o destino de um número de entrada para executar fluxo avançado, fila, ramal, URA ou outro caminho de telefonia. - https://agilize.app/docs/desenvolvedores/guias-integracao: Guias de integração - Guias práticos para entender autenticação, primeiros passos e tratamento de webhooks. - https://agilize.app/docs/desenvolvedores/guias-integracao/webhooks: Webhooks - Como preparar um endpoint para receber eventos enviados pela Agilize. - https://agilize.app/docs/desenvolvedores/referencia-tecnica: Referência técnica - Referência interativa da API, endpoints gerados pelo OpenAPI e webhooks técnicos. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/api: Endpoints da API - Referência dos métodos da API Agilize organizada por assunto e serviço. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead: CRM - Lead - Eventos de webhook da Agilize para CRM - Lead. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/funil: Funil - Webhooks da Agilize para Funil em CRM - Lead. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/funil/post-crm-lead-funnel-create: Funil - Criação - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/funil/post-crm-lead-funnel-patch: Funil - Atualização - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/funil/post-crm-lead-funnel-remove: Funil - Exclusão - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/oportunidade: Oportunidade - Webhooks da Agilize para Oportunidade em CRM - Lead. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/oportunidade/post-crm-lead-lead-create: Oportunidade - Criação - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/oportunidade/post-crm-lead-lead-patch: Oportunidade - Atualização - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/oportunidade/post-crm-lead-lead-remove: Oportunidade - Exclusão - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/origem-de-oportunidade: Origem de oportunidade - Webhooks da Agilize para Origem de oportunidade em CRM - Lead. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/origem-de-oportunidade/post-crm-lead-source-create: Origem de oportunidade - Criação - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/origem-de-oportunidade/post-crm-lead-source-patch: Origem de oportunidade - Atualização - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/origem-de-oportunidade/post-crm-lead-source-remove: Origem de oportunidade - Exclusão - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support: CRM - Support - Eventos de webhook da Agilize para CRM - Support. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support/suporte: Suporte - Webhooks da Agilize para Suporte em CRM - Support. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support/suporte/post-crm-support-support-create: Suporte - Criação - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support/suporte/post-crm-support-support-patch: Suporte - Atualização - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support/suporte/post-crm-support-support-remove: Suporte - Exclusão - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload: File - Upload - Eventos de webhook da Agilize para File - Upload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload/documento: Documento - Webhooks da Agilize para Documento em File - Upload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload/documento/post-file-upload-create: Documento - Criação - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload/documento/post-file-upload-patch: Documento - Atualização - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload/documento/post-file-upload-remove: Documento - Exclusão - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat: Messenger - Chat - Eventos de webhook da Agilize para Messenger - Chat. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat/sala-de-conversa: Sala de Conversa - Webhooks da Agilize para Sala de Conversa em Messenger - Chat. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat/sala-de-conversa/post-messenger-chat-room-create: Sala de Conversa - Criação - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat/sala-de-conversa/post-messenger-chat-room-patch: Sala de Conversa - Atualização - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat/sala-de-conversa/post-messenger-chat-room-remove: Sala de Conversa - Exclusão - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot: Messenger - Chatbot - Eventos de webhook da Agilize para Messenger - Chatbot. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot/chatbot: Chatbot - Webhooks da Agilize para Chatbot em Messenger - Chatbot. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot/chatbot/post-messenger-chatbot-nodehttpdelegate: Controle Fluxo de Chatbot - Metodo HTTP que aceita um POST para processamento de mensagens. Retorno de um JSON contendo mensagens, controle do fluxo, e variáveis. Tempo limite para geração do conteúdo de até 5 minutos. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot/chatbot/post-messenger-chatbot-nodehttpwebhook: Webhook HTTP (Saída) do Chatbot - Estrutura enviada pelo node NodeHttpWebhook para a URL configurada no fluxo. Este endpoint deve ser implementado pelo cliente/terceiro para receber os dados e reagir conforme necessário. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx: Voice - PBX - Eventos de webhook da Agilize para Voice - PBX. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/call: Call - Webhooks da Agilize para Call em Voice - PBX. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/call/post-voice-pbx-call-link: Call - Vinculação - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/call/post-voice-pbx-call-unlink: Call - Desvinculação - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/channel: Channel - Webhooks da Agilize para Channel em Voice - PBX. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/channel/post-voice-pbx-channel-dial: Channel - Discagem - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/channel/post-voice-pbx-channel-hangup: Channel - Encerramento - Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - https://agilize.app/docs/primeiros-passos/como-a-operacao-se-organiza: Como a operação se organiza na Agilize - Entenda o fluxo ponta a ponta da operação: entrada do contato, distribuição, atendimento, CRM, próximas ações, automações e acompanhamento. - https://agilize.app/docs/primeiros-passos/glossario-da-plataforma: Glossário da plataforma - Entenda os principais termos usados na Agilize em atendimento, CRM, canais, automações, permissões e configuração. - https://agilize.app/docs/primeiros-passos/papeis-e-responsabilidades: Papéis e responsabilidades - Entenda a diferença entre operador, gestor, administrador e integrador na Agilize, e saiba o que cada perfil deve operar, configurar ou acompanhar. - https://agilize.app/docs/primeiros-passos/primeiros-30-minutos: Guia de primeiros 30 minutos - Roteiro rápido para reconhecer as áreas principais da Agilize, entender a rotina pelo Flow e validar configurações básicas antes de operar. - https://agilize.app/docs/usuarios/crm-relacionamento: CRM e relacionamento - Guias para oportunidades, contatos, empresas, tarefas, suporte e classificação operacional. - https://agilize.app/docs/usuarios/crm-relacionamento/contatos-e-empresas: Contatos e empresas - Como consultar, criar, atualizar e relacionar contatos e empresas na Agilize para manter histórico, canais de comunicação e oportunidades organizados. - https://agilize.app/docs/usuarios/crm-relacionamento/suporte-e-registros-de-atendimento: Suporte e registros de atendimento - Como abrir, classificar, acompanhar e encerrar registros de suporte na Agilize usando categoria, prioridade, SLA, responsável, histórico e Flow. - https://agilize.app/docs/usuarios/crm-relacionamento/tags-e-classificacao-operacional: Tags e classificação operacional - Como usar tags na Agilize para classificar conversas, chamadas, suportes, oportunidades, contatos, empresas e históricos sem poluir relatórios e automações. - https://agilize.app/docs/usuarios/crm-relacionamento/tarefas-e-proximas-acoes: Tarefas e próximas ações - Como criar, acompanhar, concluir e organizar tarefas na Agilize para manter continuidade em atendimentos, oportunidades, contatos e empresas. - https://agilize.app/docs/usuarios/flow-e-atendimento: Flow e atendimento - Guias para operar conversas, canais, sessão WhatsApp, bots e atendimento humano a partir do Flow. - https://agilize.app/docs/usuarios/flow-e-atendimento/caixa-de-entrada-e-filas-de-atendimento: Caixa de entrada e filas de atendimento - Como acompanhar filas de atendimento, priorizar conversas, entender status, responsáveis, departamentos e evitar conversas paradas. - https://agilize.app/docs/usuarios/flow-e-atendimento/chat-interno-e-salas-internas: Chat interno e salas internas - Como usar o chat interno do Flow para conversas diretas, grupos e canais do projeto sem misturar alinhamentos internos com atendimento ao cliente. - https://agilize.app/docs/usuarios/flow-e-atendimento/execucao-operacional-de-fluxos-do-bot: Execução operacional de fluxos do bot - Como interpretar intervenções do bot, retomadas de fluxo, desvios, transferências e encerramentos automáticos durante a rotina de atendimento. - https://agilize.app/docs/usuarios/flow-e-atendimento/flow-na-rotina-operacional: Flow na rotina operacional - Como usar o Flow como central diária de conversas, tarefas, leads, suporte, processos e ações que precisam de acompanhamento. - https://agilize.app/docs/usuarios/flow-e-atendimento/fluxo-de-conversa-e-conclusao-do-atendimento: Fluxo de conversa e conclusão do atendimento - Como conduzir uma conversa depois da distribuição, registrar contexto, transferir quando necessário e concluir o atendimento sem quebrar a continuidade. - https://agilize.app/docs/usuarios/flow-e-atendimento/sessao-de-24-horas-no-whatsapp: Sessão de 24 horas no WhatsApp - Como funciona a janela de resposta livre do WhatsApp na Agilize, quando usar modelos aprovados e como evitar conversas paradas. - https://agilize.app/docs/usuarios/flow-e-atendimento/whatsapp-chat-sms-e-telefone-na-rotina: WhatsApp, chat, SMS e telefone na rotina - Como escolher e operar cada canal de atendimento na Agilize, mantendo contexto, histórico, responsável e continuidade comercial. - https://agilize.app/docs/usuarios/relatorios-bi: Relatórios e BI - Guias para criar relatórios, escolher fontes de dados, aplicar filtros e usar exemplos prontos. - https://agilize.app/docs/usuarios/relatorios-bi/relatorios-e-indicadores: Relatórios e indicadores - Como acompanhar volume por canal, conversões, oportunidades por etapa, produtividade, tempo de resposta, origem e qualidade para tomar decisões operacionais. - https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-criacao-item-relatorio: Criar item de relatório - Como criar um item de relatório no BI da Agilize, escolhendo fonte de dados, visualização, eixos, agregações, filtros, configuração visual e painel. - https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-exemplos-prontos: Exemplos prontos - Biblioteca de exemplos para montar relatórios de atendimento, CRM, suporte, tarefas, ligações e campanhas no BI da Agilize. - https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-filtros-periodos-agregacoes: Filtros, períodos e agregações - Como usar período global, filtros por campo, agrupamentos de data e agregações no BI da Agilize sem distorcer a leitura dos relatórios. - https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-fontes-dados-campos: Fontes de dados e campos - Referência das fontes de dados do BI da Agilize, com campos disponíveis, tipos, datas, métricas, segmentações e exemplos de uso. - https://agilize.app/docs/usuarios/rh-jornada: RH e jornada - Guias operacionais de jornada, ponto, ocorrências, aprovações e acompanhamento de RH. - https://agilize.app/docs/usuarios/rh-jornada/rh-e-jornada-na-rotina: RH e jornada na rotina - Como colaboradores, gestores e RH usam o Workforce para registrar jornada, controlar status, acompanhar ponto, aprovar ocorrências e consultar relatórios. - https://agilize.app/docs/usuarios/rotinas-por-perfil: Rotinas por perfil - Checklists recomendados para operador e gestor manterem a operação previsível. - https://agilize.app/docs/usuarios/rotinas-por-perfil/rotina-recomendada-do-gestor: Rotina recomendada do gestor - Checklist semanal para gestores acompanharem gargalos, oportunidades paradas, qualidade de dados, uso de tags, performance por canal, produtividade e SLA na Agilize. - https://agilize.app/docs/usuarios/rotinas-por-perfil/rotina-recomendada-do-operador: Rotina recomendada do operador - Checklist diário para revisar o Flow, responder pendências, atualizar oportunidades, registrar próximas ações, acompanhar suporte e concluir tarefas na Agilize. - https://agilize.app/docs/usuarios/transmissoes-e-telefonia: Transmissões e telefonia - Guias de transmissão em massa, voz, WhatsApp e monitoramento de telefonia. - https://agilize.app/docs/usuarios/transmissoes-e-telefonia/monitoramento-de-telefonia: Monitoramento de Telefonia - Como acompanhar ramais, filas, chamadas aguardando, chamadas em atendimento e ações de supervisão da operação de voz. - https://agilize.app/docs/usuarios/transmissoes-e-telefonia/transmissao-em-massa-por-whatsapp-e-voz: Transmissão em massa por WhatsApp e Voz - Como preparar listas, criar disparos em massa por WhatsApp ou ligação, acompanhar status, falhas e respostas sem perder governança. ## Detalhes dos guias ### Documentação Agilize - URL: https://agilize.app/docs - Resumo: Guias oficiais para operação, configuração e desenvolvimento na plataforma Agilize. - Seções: Comece pelo seu objetivo | Destaque: Flow | Padrão da documentação - Conteúdo útil: Documentação Agilize Use esta central para entender a operação no produto, configurar a plataforma com segurança e integrar sistemas externos à API Agilize. Comece pelo seu objetivo - Introdução: entenda a lógica central da plataforma, os principais conceitos e o caminho recomendado para começar. - Operação: consulte os guias de atendimento, CRM, oportunidades, automações e rotina operacional. - Configuração: prepare canais, integrações, funis, usuários, permissões, tags e regras antes de escalar o uso. - Desenvolvedores: use os guias técnicos para autenticação, webhooks, endpoints e referência da API. Destaque: Flow O Flow é o eixo transversal da experiência Agilize. Ele acompanha a rotina... ### Introdução - URL: https://agilize.app/docs/primeiros-passos - Resumo: Visão inicial da plataforma, dos conceitos principais e do caminho recomendado para começar. - Seções: Guias disponíveis - Conteúdo útil: Introdução Comece por aqui para entender como a Agilize conecta canais, contatos, oportunidades, automações e indicadores. Guias disponíveis - Visão geral da Agilize - Como a operação se organiza na Agilize - Glossário da plataforma - Guia de primeiros 30 minutos - Papéis e responsabilidades ### Visão geral da Agilize - URL: https://agilize.app/docs/primeiros-passos/visao-geral - Resumo: Entenda como a Agilize conecta canais, Flow, atendimento, CRM, automações, tarefas, usuários e permissões em uma operação única. - Seções: Quando usar este guia | Lógica central | Conceitos principais | Áreas da documentação | Introdução | Operação | Configuração | Desenvolvedores - Conteúdo útil: Visão geral da Agilize A Agilize reúne atendimento, CRM, automações e gestão operacional em uma rotina única. O objetivo é fazer com que cada conversa, contato, empresa, oportunidade e tarefa tenha contexto, responsável e próximo passo claro. Use este guia para entender a lógica central da plataforma antes de configurar canais, funis, permissões, fluxos ou integrações. ::DocsDiagram --- title: "Como a operação se conecta" caption: "Os canais trazem interações, o Flow centraliza o que precisa de ação e o CRM mantém histórico, próximas ações e acompanhamento." definition: | flowchart LR A[Canais] --> B[Flow] B --> C[Atendimento] C --> D[Contatos e empresas] D --> E[Oportunidades] E --> F[Tare... ### Operação - URL: https://agilize.app/docs/usuarios - Resumo: Guias de uso para atendimento, CRM, oportunidades, automações e rotina diária. - Seções: Grupos de operação - Conteúdo útil: Operação Esta seção reúne guias para quem usa a Agilize na rotina de atendimento, vendas, suporte e gestão operacional. Grupos de operação - Flow e atendimento: conversas, canais, sessão WhatsApp, bot e atendimento humano. - CRM e relacionamento: oportunidades, contatos, tarefas, suporte e tags. - Transmissões e telefonia: disparos, voz e monitoramento. - RH e jornada: rotina de jornada e acompanhamento. - Relatórios e BI: indicadores, fontes, filtros e exemplos prontos. - Rotinas por perfil: checklists para operador e gestor. ### Atendimento omnichannel - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/atendimento-omnichannel - Resumo: Como atender conversas de diferentes canais pela Agilize, mantendo responsável, histórico, contexto e continuidade operacional. - Seções: Quando usar | Onde o atendimento começa | O que conferir ao abrir uma conversa | Como conduzir o atendimento | Canais e cuidados operacionais | Assumir, adicionar pessoas e transferir | Histórico, busca e contexto | Atalhos, modelos e mensagens agendadas - Conteúdo útil: Atendimento omnichannel O atendimento omnichannel na Agilize organiza conversas de diferentes canais em uma rotina única de trabalho. O objetivo é responder com contexto, manter responsável definido, preservar histórico e permitir que a operação continue entre atendimento, CRM, suporte e automações. Use este guia para orientar operadores e gestores na rotina diária de atendimento. !Flow do usuário com conversas de diferentes canais e tarefas operacionais Quando usar Use este guia quando a equipe precisa: - atender conversas vindas de WhatsApp, LiveChat, Facebook, Instagram ou SMS; - iniciar atendimentos distribuídos para o usuário; - consultar histórico antes de responder; - transferir a co... ### CRM e oportunidades - URL: https://agilize.app/docs/usuarios/crm-relacionamento/crm-e-oportunidades - Resumo: Como criar, qualificar, movimentar e acompanhar oportunidades no CRM da Agilize usando funis, etapas, responsáveis, valor, origem, score e próximas ações. - Seções: Quando usar | Visão geral do fluxo | Acessar oportunidades | Criar uma oportunidade | Usar o quadro kanban | Filtrar e ordenar oportunidades | Atualizar qualidade, valor e responsável | Mover etapas - Conteúdo útil: CRM e oportunidades O CRM da Agilize organiza oportunidades em funis e etapas para que o time acompanhe cada negociação com contexto, responsável, valor, origem, qualidade e próxima ação. Use este guia para operar oportunidades no dia a dia: criar registros, manter dados essenciais, mover etapas, definir responsável, registrar tarefas e evitar que oportunidades fiquem paradas. Quando usar Use este guia quando você precisa: - criar uma nova oportunidade; - acompanhar oportunidades em quadro kanban; - selecionar funil e etapa; - registrar origem, valor, contato, empresa e responsável; - classificar a qualidade da oportunidade pelo termômetro/score; - mover oportunidades entre etapas; - ganhar... ### Automações e IA - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/automacoes-e-ia - Resumo: Como usar automações, fluxos e agentes de IA no dia a dia sem perder governança, contexto e controle operacional. - Seções: Onde entram na rotina | Quando confiar | Quando revisar | Como supervisionar | Como corrigir comportamento | Corrigir o caso atual | Tratar a causa | Boas práticas para IA - Conteúdo útil: Automações e IA Automações e IA ajudam a reduzir tarefas repetitivas, acelerar respostas, classificar demandas, criar tarefas, atualizar registros e encaminhar conversas para o caminho correto. No dia a dia, elas devem funcionar como apoio operacional: a regra executa o que foi configurado, e a equipe valida se o resultado fez sentido para o cliente, para o CRM e para o atendimento. Use este guia para saber quando confiar, quando revisar, como supervisionar e como corrigir comportamentos inesperados. ::DocsDiagram --- title: "Governança recomendada" caption: "A automação executa a rotina; a equipe acompanha o resultado e corrige exceções." definition: | flowchart LR A[Evento ou conversa] --... ### Configuração - URL: https://agilize.app/docs/configuracao - Resumo: Guias para preparar canais, funis, usuários, permissões e regras da plataforma. - Seções: Antes de configurar | Grupos de configuração - Conteúdo útil: Configuração Use esta seção para preparar a Agilize antes da operação diária. A configuração define canais, funis, responsáveis, permissões, automações e regras que sustentam atendimento e CRM. Antes de configurar - Confirme quem será responsável por administrar a conta. - Defina quais canais, equipes e funis entram na primeira etapa. - Evite criar regras sem saber qual rotina operacional elas apoiam. - Valide permissões antes de liberar o acesso para novos usuários. Grupos de configuração - Implantação e go-live: primeira configuração, checklist e troubleshooting. - Acessos e segurança: usuários, equipes, permissões e governança. - Canais, WhatsApp e integrações: canais, modelos, listas e... ### Canais e integrações - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/canais-e-integracoes - Resumo: Como conectar, configurar, testar e governar canais de atendimento e integrações externas na Agilize. - Seções: Canal ou integração | Antes de começar | Onde configurar | Configure WhatsApp com destino operacional | Configure LiveChat para o site certo | Configure departamentos antes de divulgar canais | Configure redes sociais com cuidado de origem | Prepare SMS como canal de apoio - Conteúdo útil: Canais e integrações Canais e integrações definem por onde clientes entram, como conversas são distribuídas, quais dados chegam ao CRM e quais sistemas externos participam da operação. Uma configuração mal testada pode criar conversas sem responsável, leads sem origem, chamadas sem destino ou eventos externos sem tratamento. Use este guia para preparar WhatsApp, LiveChat, redes sociais, SMS, telefonia, webhooks e integrações de terceiros antes do go-live. ::DocsDiagram --- title: "Ciclo seguro de configuração" caption: "Todo canal deve ser conectado, direcionado, testado e acompanhado antes de ser divulgado para clientes." definition: | flowchart LR A[Definir objetivo do canal] --> B[Conect... ### Funis, etapas e origens - URL: https://agilize.app/docs/configuracao/crm-dados/funis-etapas-e-origens - Resumo: Como configurar funis, etapas e origens para organizar oportunidades, automações, relatórios e rotinas comerciais na Agilize. - Seções: Quando configurar | Caminhos principais | Antes de desenhar o funil | Campos do funil | Como desenhar etapas | Campos da etapa | Exigências para avançar | Etapas finais, ganho e arquivamento - Conteúdo útil: Funis, etapas e origens Funis, etapas e origens formam a base de organização das oportunidades na Agilize. Eles definem onde cada oportunidade está na jornada, qual foi o caminho de entrada, quais dados precisam ser preenchidos antes de avançar e como a gestão vai acompanhar conversões, gargalos e qualidade por canal. Use este guia antes de criar automações, importar bases, configurar transmissões, montar relatórios ou colocar o CRM em operação. ::DocsDiagram --- title: "Como funil, etapa e origem se conectam" caption: "O funil organiza a jornada, as etapas controlam o avanço e a origem explica de onde a oportunidade veio." definition: | flowchart LR A[Origem] --> B[Oportunidade] B --> C[Fu... ### Usuários, equipes e permissões - URL: https://agilize.app/docs/configuracao/acessos-seguranca/usuarios-equipes-e-permissoes - Resumo: Como configurar usuários, funções, equipes de distribuição, equipes organizacionais e escopo de dados na Agilize com segurança operacional. - Seções: Como os acessos se combinam | Regra central de escopo de dados | Antes de começar | Crie usuários com identidade individual | Configure as flags operacionais do usuário | Configure notificações por perfil | Use funções para liberar telas e ações | Diferencie equipe de distribuição e equipe organizacional - Conteúdo útil: Usuários, equipes e permissões Usuários, equipes e permissões definem quem acessa a Agilize, quais áreas cada pessoa consegue usar, quais registros aparecem para ela e como atendimentos, tarefas, oportunidades, suportes e relatórios são distribuídos ou supervisionados. Use este guia para configurar acessos em https://my.agilize.app/user, https://my.agilize.app/team, https://my.agilize.app/teamOrg e https://my.agilize.app/permission/role. Acesso pela tela: use a navbar superior para abrir Configurações. Na tree de Configurações, abra Gerenciar Usuários, Permissões ou Equipes (Organizacional). Para equipes de distribuição, use sidebar lateral > módulo CRM/Hub > Configurações e abra Equipes de... ### Tags e regras - URL: https://agilize.app/docs/configuracao/crm-dados/tags-automacoes-e-regras - Resumo: Padronize classificações e regras de uso para manter a operação rastreável e consistente. - Seções: Como começar | Cuidados - Conteúdo útil: Tags e regras Tags e regras ajudam a classificar contatos, direcionar demandas e manter dados confiáveis. A configuração precisa ser simples o suficiente para o time entender e consistente o bastante para sustentar filtros, relatórios e automações. Como começar - Crie tags com nomes claros e reutilizáveis. - Documente quando cada tag deve ser usada. - Defina quais regras dependem de tags, origem, etapa, canal ou responsável. - Teste regras com registros controlados antes de ativar para toda a operação. Para configurar ações específicas de automação, consulte o guia de Automações de CRM. Cuidados Evite criar muitas tags ou regras parecidas. Quanto mais difícil for entender a classificação, m... ### Desenvolvedores - URL: https://agilize.app/docs/desenvolvedores - Resumo: Guias técnicos para autenticação, webhooks e integração com a API Agilize. - Seções: Grupos técnicos - Conteúdo útil: Desenvolvedores Esta seção reúne o conteúdo técnico para integrar sistemas externos à Agilize. Grupos técnicos - Guias de integração: conceitos, autenticação e uso de webhooks. - Referência técnica: referência interativa, endpoints da API e webhooks técnicos. ### Introdução à API - URL: https://agilize.app/docs/desenvolvedores/guias-integracao/introducao - Resumo: Visão geral para integrar sistemas externos à API Agilize. - Seções: Antes de começar | URL base - Conteúdo útil: Introdução à API A API Agilize permite integrar sistemas externos à operação omnichannel, CRM, canais de atendimento e rotinas de automação. Antes de começar - Defina qual processo será integrado. - Confirme quais dados precisam trafegar entre os sistemas. - Gere uma chave de acesso no ambiente autorizado. - Teste primeiro em uma operação controlada. URL base http https://api.agilize.app/ Use a referência da API para consultar endpoints, parâmetros e formatos de resposta. ### Autenticação - URL: https://agilize.app/docs/desenvolvedores/guias-integracao/autenticacao - Resumo: Como autenticar chamadas na API Agilize usando chave de acesso. - Seções: Cabeçalhos principais | Exemplo | Segurança - Conteúdo útil: Autenticação As requisições para a API devem incluir a chave de acesso no cabeçalho da chamada. Cabeçalhos principais http Accept: application/json x-api-key: SUACHAVEAPI Exemplo bash curl --request GET \ --url "https://api.agilize.app/" \ --header "Accept: application/json" \ --header "x-api-key: SUACHAVEAPI" Segurança Nunca exponha a chave de acesso em código público, documentação pública, logs abertos ou aplicações client-side. ### Referência da API - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/referencia-api - Resumo: Documentação interativa dos endpoints da API Agilize. - Seções: Base da API | Exemplos rápidos | Testar e gerar código - Conteúdo útil: Referência da API A referência abaixo reúne os endpoints públicos da API Agilize para consulta, teste de requisições e geração de exemplos de código. Ela segue o padrão esperado para documentação técnica: busca por endpoints, detalhes de parâmetros e respostas, botão de teste de requisição e exemplos básicos por linguagem. Base da API text https://api.agilize.app As chamadas autenticadas usam a chave de API no cabeçalho: http Accept: application/json x-api-key: SUACHAVEAPI Exemplos rápidos Os exemplos abaixo usam a listagem de oportunidades como ponto de partida. Para outros recursos, selecione o endpoint correspondente na referência interativa e use o gerador de código. bash curl --request... ### Webhooks técnicos - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks - Resumo: Eventos de webhook da Agilize organizados por assunto e serviço. - Seções: Assuntos | Guias relacionados - Conteúdo útil: Esta seção organiza os webhooks técnicos por assunto. Use estas páginas como referência de consulta para entender eventos, payloads, respostas esperadas e integração com sistemas externos. Assuntos - File - Upload - 3 eventos - CRM - Lead - 9 eventos - CRM - Support - 3 eventos - Messenger - Chat - 3 eventos - Messenger - Chatbot - 2 eventos - Voice - PBX - 4 eventos Guias relacionados - Webhooks de integração - Autenticação da API - Referência interativa da API ### Acessos e segurança - URL: https://agilize.app/docs/configuracao/acessos-seguranca - Resumo: Guias para usuários, equipes, permissões, governança de acesso e segurança operacional. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Acessos e segurança Esta seção concentra os guias de acesso, permissões e governança. Use-a antes de liberar novos usuários ou áreas sensíveis da plataforma. Guias desta seção - Usuários, equipes e permissões. - Escopo de dados por equipe organizacional. - Segurança operacional. Próximo passo Depois de revisar acesso, configure Canais, WhatsApp e integrações. ### Escopo de dados por equipe organizacional - URL: https://agilize.app/docs/configuracao/acessos-seguranca/escopo-dados-equipe-organizacional - Resumo: Como usar equipes organizacionais, supervisores e registros próprios para controlar acesso a oportunidades, contatos, relatórios e dados operacionais. - Seções: Quando usar | Como o acesso é calculado | Cenários recomendados | Configure a equipe organizacional | Configure usuários e registros próprios | Impacto em relatórios e dados operacionais | Boas práticas | Problemas comuns - Conteúdo útil: Escopo de dados por equipe organizacional Equipes organizacionais são usadas para controlar quais dados cada líder, supervisor ou operador consegue consultar. Elas ajudam a dar visão de time sem transformar todos os gestores em administradores. Use este guia quando um usuário não administrador precisa acompanhar leads, contatos, relatórios, atendimentos, tarefas ou suportes de uma equipe. Quando usar Use equipe organizacional para responder perguntas como: - quais registros este operador pode ver? - quais oportunidades pertencem ao time deste supervisor? - quais contatos, tarefas e atendimentos podem aparecer nos relatórios do líder? - como limitar a visão de dados sem bloquear a rotina de... ### Segurança operacional - URL: https://agilize.app/docs/configuracao/acessos-seguranca/seguranca-operacional - Resumo: Como revisar acessos, permissões, equipes, canais, automações e integrações para reduzir risco operacional. - Seções: Áreas principais | Princípio de menor privilégio | Revisão de usuários | Permissões sensíveis | Canais e mensagens | Automações e integrações | Rotina de revisão | Checklist rápido - Conteúdo útil: Segurança operacional Segurança operacional é o conjunto de práticas que evita acesso indevido, alteração acidental, envio errado de mensagens e exposição de dados. Na Agilize, ela envolve usuários, permissões, equipes, canais, automações, integrações e revisão periódica. Áreas principais | Área | Caminho público | O que revisar | | --- | --- | --- | | Usuários | https://my.agilize.app/user/ | Contas ativas, e-mail, perfil, equipe e desligamentos. | | Permissões | https://my.agilize.app/permission/role | Perfis de acesso, permissões administrativas e módulos sensíveis. | | Equipes organizacionais | https://my.agilize.app/teamOrg/ | Escopo de dados, supervisores, líderes, usuários do time e... ### Canais, WhatsApp e integrações - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes - Resumo: Guias para conectar canais, cadastrar modelos, organizar listas e preparar transmissões. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Canais, WhatsApp e integrações Use esta seção para preparar os canais que conectam a operação ao cliente: WhatsApp, chat, SMS, voz, listas e transmissões. Guias desta seção - Canais e integrações. - Integrar Instagram pela primeira vez. - Ativar eventos em uma conta Instagram já integrada. - Cadastro de modelos de mensagem WhatsApp. - Modelos, mensagens e respostas rápidas. - Listas de transmissão. - Configuração de transmissão em massa por WhatsApp. - Configuração de transmissão em massa por Voz. Próximo passo Para organizar dados comerciais, siga para CRM, funis e dados. ### Ativar eventos em uma conta Instagram já integrada - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/ativar-eventos-instagram-conta-integrada - Resumo: Como habilitar comentários, lives, Stories e reações em uma Página Instagram já conectada à Agilize, sem perder o Direct atual. - Seções: Onde acessar | Quando usar este ajuste | Passo a passo | Eventos da Página | Entenda os status | Filtros de Story | Ative a automação social na Página | Como validar - Conteúdo útil: Ativar eventos em uma conta Instagram já integrada Contas Instagram conectadas antes da liberação de comentários podem continuar recebendo Direct normalmente, mas talvez ainda não estejam autorizadas para comentários em posts/Reels ou lives. Nesses casos, a ativação é feita na edição da própria Página Instagram. Use este guia quando a conta já aparece em Páginas do Instagram e você quer adicionar ou revisar eventos. ::DocsDiagram --- title: "Ativação sem perder o Direct" caption: "O Direct atual é preservado enquanto a Página recebe novos eventos e, se necessário, passa por nova confirmação na Meta." definition: | flowchart LR A[Página Instagram já integrada] --> B[Ajustar eventos] B --> C[... ### Cadastro de modelos de mensagem WhatsApp - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/cadastro-de-modelos-de-mensagem-whatsapp - Resumo: Como criar, revisar, aprovar e manter modelos de WhatsApp para retomadas, transmissões, fluxos, automações e follow-ups na Agilize. - Seções: Quando usar modelos | Antes de começar | Campos do cadastro | Limites e comportamentos do editor | Escolha a categoria correta | Como aumentar a chance de aprovar como Utilidade | Escreva o nome do modelo | Monte o corpo da mensagem - Conteúdo útil: Cadastro de modelos de mensagem WhatsApp Modelos de mensagem WhatsApp são mensagens pré-aprovadas usadas quando a operação precisa iniciar ou retomar contato ativo com o cliente. Eles são essenciais para conversas fora da sessão de 24 horas, transmissões em massa, fluxos do bot, automações de CRM, lembretes, avaliações e follow-ups comerciais. Use este guia para cadastrar modelos claros, aprováveis e reutilizáveis, sem perder contexto nem gerar mensagens genéricas. ::DocsDiagram --- title: "Ciclo de vida do modelo" caption: "Um modelo nasce como configuração, passa por aprovação do canal e depois pode ser usado em operações controladas." definition: | flowchart LR A[Planejar finalidade] -->... ### Integrar Instagram pela primeira vez - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/integrar-instagram-nova-conta - Resumo: Passo a passo para conectar uma nova conta do Instagram à Agilize, escolher eventos iniciais e validar Direct, Stories, comentários e lives. - Seções: Antes de começar | Onde acessar | Passo a passo | Eventos disponíveis na integração | Configurações recomendadas depois da integração | Como validar | Problemas comuns | Próximos passos - Conteúdo útil: Integrar Instagram pela primeira vez A integração do Instagram conecta a conta profissional à Agilize para centralizar conversas do Direct, respostas de Story, reações, comentários em posts/Reels e comentários em lives. A conexão é feita pelo login da Meta e salva os recursos autorizados em cada Página Instagram integrada. Use este guia quando a conta ainda não aparece em Páginas do Instagram na Agilize. ::DocsDiagram --- title: "Ciclo da integração" caption: "A conta precisa estar preparada na Meta antes de receber eventos e executar automações na Agilize." definition: | flowchart LR A[Preparar Instagram profissional] --> B[Vincular à Página do Facebook] B --> C[Integrar Instagram na Agili... ### Listas de transmissão - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/listas-de-transmissao - Resumo: Como criar, alimentar, revisar e manter listas de transmissão para WhatsApp, Voz, automações e campanhas segmentadas. - Seções: Quando usar | Caminhos principais | Tipos de contato | Criar uma lista | Nomear listas com governança | Adicionar contatos por filtro | Adicionar por importação | Adicionar ou remover por automação - Conteúdo útil: Listas de transmissão Listas de transmissão organizam o público que será usado em disparos, cadências e automações. Elas permitem separar bases por objetivo, tipo de registro, canal, campanha, origem e contexto operacional. Use este guia para criar listas reutilizáveis, adicionar contatos com segurança e manter a base limpa antes de iniciar transmissões por WhatsApp, Voz ou automações. ::DocsDiagram --- title: "Ciclo de uma lista de transmissão" caption: "A lista nasce com um tipo de contato, recebe itens por filtros, importação ou automação e depois pode ser usada em disparos e cadências." definition: | flowchart LR A[Criar lista] --> B[Escolher tipo de contato] B --> C{Como alimentar?} C... ### Modelos, mensagens e respostas rápidas - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/modelos-mensagens-respostas-rapidas - Resumo: Como organizar modelos WhatsApp, atalhos, categorias e padrões de comunicação para atendimento e automações. - Seções: Tipos de mensagem | Quando usar cada recurso | Campos dos atalhos | Padrão de escrita | Variáveis e personalização | Governança dos textos | Exemplos de categorias úteis | Cuidados em automações - Conteúdo útil: Modelos, mensagens e respostas rápidas Modelos, atalhos e respostas rápidas ajudam a manter comunicação consistente sem transformar o atendimento em texto engessado. A regra principal é simples: padronize o que é recorrente, mas preserve contexto para o operador adaptar a conversa. Tipos de mensagem | Recurso | Onde configurar | Quando usar | | --- | --- | --- | | Modelos de mensagem WhatsApp | https://my.agilize.app/messenger/chat/messageTemplate | Iniciar ou retomar contato pelo WhatsApp, especialmente fora da sessão de 24 horas. | | Atalhos de mensagem | https://my.agilize.app/messenger/chat/shortcut | Respostas recorrentes usadas no atendimento diário pelo operador. | | Categorias de at... ### Configuração de transmissão em massa por Voz - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/transmissao-em-massa-voz - Resumo: Como configurar, iniciar e acompanhar disparos em massa por ligação usando listas, fluxo de chamada, horário permitido e chamadas simultâneas. - Seções: Quando usar | Caminhos principais | Antes de começar | Campos do disparo | Preparar a lista | Configurar horário permitido | Escolher o fluxo da chamada | Definir chamadas simultâneas - Conteúdo útil: Configuração de transmissão em massa por Voz A transmissão em massa por Voz permite ligar para uma lista de contatos e executar um fluxo telefônico quando a chamada é atendida. Ela é útil para avisos urgentes, confirmações, pesquisas, cobranças, reativações e operações em que a ligação tem mais chance de resposta do que uma mensagem. Use este guia para configurar disparos com controle de horário, capacidade simultânea e roteiro de chamada. ::DocsDiagram --- title: "Fluxo do discador automático" caption: "A lista define quem será chamado. O fluxo de voz define o que acontece quando a pessoa atende." definition: | flowchart LR A[Preparar lista de transmissão] --> B[Selecionar canal Ligação] B... ### Configuração de transmissão em massa por WhatsApp - URL: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/transmissao-em-massa-whatsapp - Resumo: Como configurar, iniciar e acompanhar disparos em massa por WhatsApp usando listas, modelos aprovados, variáveis e rastreamento de respostas. - Seções: Quando usar | Caminhos principais | Antes de começar | Campos do disparo | Escolher a lista certa | Escolher WhatsApp / Business | Escolher o modelo de mensagem | Preencher variáveis - Conteúdo útil: Configuração de transmissão em massa por WhatsApp A transmissão em massa por WhatsApp permite enviar um modelo aprovado para uma lista de contatos revisada. Ela deve ser usada com planejamento, porque o envio acontece contra destinatários reais, pode gerar custo no WhatsApp/Meta e pode gerar respostas que precisam ser acompanhadas pela equipe. Use este guia para configurar disparos previsíveis, com lista correta, número certo, variáveis preenchidas e rastreamento de retorno. ::DocsDiagram --- title: "Fluxo de configuração do disparo" caption: "Um disparo seguro começa na preparação da base e termina no acompanhamento de envio, falhas e respostas." definition: | flowchart LR A[Preparar lista... ### CRM, funis e dados - URL: https://agilize.app/docs/configuracao/crm-dados - Resumo: Guias de funis, etapas, origens, campos obrigatórios, qualidade de dados e tags. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: CRM, funis e dados Esta seção reúne a base de dados da operação: funis, etapas, origens, campos obrigatórios, qualidade dos cadastros e tags. Guias desta seção - Funis, etapas e origens. - Campos e dados obrigatórios. - Importar leads por CSV. - Qualidade de dados e prevenção de duplicidade. - Tags e regras. Próximo passo Depois de organizar os dados, configure Roteamento e distribuição. ### Campos e dados obrigatórios - URL: https://agilize.app/docs/configuracao/crm-dados/campos-e-dados-obrigatorios - Resumo: Como definir dados mínimos e campos obrigatórios para contatos, empresas, oportunidades e suporte sem prejudicar a operação diária. - Seções: Quando configurar | Caminhos principais | O que é obrigatório e o que é recomendado | Dados mínimos por tipo de registro | Contatos | Empresas | Oportunidades | Campos obrigatórios por etapa - Conteúdo útil: Campos e dados obrigatórios Campos obrigatórios existem para proteger a operação de cadastros incompletos. Eles ajudam o time a atender, vender, distribuir demandas, executar automações e gerar relatórios com confiança. Use este guia para decidir quais dados devem ser preenchidos em contatos, empresas, oportunidades e suportes, sem criar barreiras desnecessárias para quem está atendendo ou registrando informações em tempo real. ::DocsDiagram --- title: "Governança de dados mínimos" caption: "A configuração deve equilibrar velocidade operacional e qualidade da base." definition: | flowchart LR A[Entrada de dados] --> B{Dado mínimo existe?} B -->|Sim| C[Operação continua] B -->|Não| D[Preench... ### Importar leads por CSV - URL: https://agilize.app/docs/configuracao/crm-dados/importar-leads-csv - Resumo: Como importar oportunidades em lote na Agilize, enviando um CSV, mapeando colunas, escolhendo funil, etapa, origem, tags, distribuição e acompanhando o resultado do processamento. - Seções: Quando usar | Onde acessar | Antes de começar | Enviar o CSV | Mapear as colunas | Usar identificadores com cuidado | Configurar a oportunidade gerada | Processar a importação - Conteúdo útil: Importar leads por CSV A importação por CSV permite criar oportunidades em lote e, quando necessário, relacionar contatos e empresas ao mesmo processo. Use esse recurso para migrar bases, carregar listas qualificadas, iniciar campanhas comerciais ou organizar registros vindos de outras ferramentas. Como a importação altera a base do CRM, trate o processo como uma atividade de configuração e governança de dados. Um arquivo bem preparado reduz duplicidades, melhora a distribuição do time e evita oportunidades sem contexto comercial. Importante: importar contatos, empresas ou oportunidades por CSV não executa automações de CRM automaticamente. A importação prepara a base; se um processo precis... ### Qualidade de dados e prevenção de duplicidade - URL: https://agilize.app/docs/configuracao/crm-dados/qualidade-dados-prevencao-duplicidade - Resumo: Como padronizar contatos, empresas, oportunidades, telefones, e-mails, campos obrigatórios e regras de duplicidade. - Seções: Cadastros principais | Padrão mínimo de dados | Telefones | E-mails | Nome, empresa e relacionamento | Origens e tags | Campos obrigatórios por etapa | Prevenção de duplicidade - Conteúdo útil: Qualidade de dados e prevenção de duplicidade Dados consistentes sustentam atendimento, CRM, automações, transmissões, relatórios e integrações. Quando nome, telefone, e-mail, origem, empresa ou responsável estão inconsistentes, a operação perde histórico e aumenta o risco de contato duplicado. Use este guia para definir padrões mínimos de cadastro e reduzir duplicidade. Cadastros principais | Cadastro | Caminho público | Papel na operação | | --- | --- | --- | | Contatos | https://my.agilize.app/crm/contact | Pessoas atendidas, compradores, solicitantes ou representantes. | | Empresas | https://my.agilize.app/crm/company | Organizações relacionadas a contatos e oportunidades. | | Oportunid... ### Fluxos e automações - URL: https://agilize.app/docs/configuracao/fluxos-automacoes - Resumo: Guias práticos de fluxos do bot, automações de CRM, cadências e governança. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Fluxos e automações Esta seção contém guias práticos para construir fluxos do bot, automações de CRM e cadências. Referências detalhadas de nodes ficam separadas em Referências de configuração. Em automações de CRM, considere uma premissa importante: importações em massa por planilha/CSV não executam fluxos automaticamente, e automações não devem ser tratadas como gatilho para outras automações. Os gatilhos esperados vêm de ações manuais de usuários, fluxos do bot, webhooks de entrada ou API. Guias desta seção - Fluxos do bot. - Guia geral de fluxos do bot. - Cenários comuns de fluxos do bot. - Agentes de IA em fluxos do bot. - Automações de CRM. - Automações sociais para comentários do Ins... ### Agentes de IA em fluxos do bot - URL: https://agilize.app/docs/configuracao/fluxos-automacoes/agentes-ia-fluxos-bot - Resumo: Como configurar conta de provedor, agente de IA, prompt, variáveis de saída, intenções e conexão com nodes em fluxos do bot. - Seções: Visão geral | Quando usar | Premissas importantes | Configure a conta do provedor | Crie o agente de IA | Escreva o prompt do agente | Configure variáveis de saída | Configure intenções - Conteúdo útil: Agentes de IA em fluxos do bot Agentes de IA ajudam o fluxo do bot a interpretar mensagens abertas, capturar informações importantes e escolher a próxima rota da conversa. Eles devem ser usados como parte de uma jornada desenhada, com intenção clara, fallback e transferência segura quando a IA não tiver confiança ou quando a decisão exigir atendimento humano. Use este guia para configurar a conta do provedor, criar o agente, definir prompt, variáveis de saída, intenções e conectar o agente ao ponto correto do fluxo. Visão geral ::DocsDiagram --- title: "Como o agente de IA entra no fluxo" caption: "A conta de integração fornece a chave, o agente define comportamento e o node conecta esse ag... ### Automações administrativas - URL: https://agilize.app/docs/configuracao/fluxos-automacoes/automacoes-administrativas - Resumo: Como governar criação, testes, ativação, pausa, ownership e auditoria de automações na Agilize. - Seções: Onde configurar | Defina ownership | Nome e descrição operacional | Ciclo de vida recomendado | Crie desativada | Teste com registros controlados | Ative gradualmente | Quando pausar - Conteúdo útil: Automações administrativas Automações administrativas são as regras que sustentam processos recorrentes da operação: distribuição, tarefas, tags, mensagens, listas, integrações e mudanças de status. Elas precisam de governança porque podem alterar dados, acionar clientes e impactar equipes inteiras. Use este guia para manter automações controladas, rastreáveis e seguras. Onde configurar As automações ficam em https://my.agilize.app/crm/automation. Acesso pela tela: sidebar lateral > módulo CRM/Hub > Configurações. Na tree de Configurações, abra Automações do CRM. Cada automação deve ter entidade, evento, status de ativação, regra de reexecução e fluxo visual. A configuração deve ser feita p... ### Automações de CRM - URL: https://agilize.app/docs/configuracao/fluxos-automacoes/automacoes-de-crm - Resumo: Como criar, testar, ativar, pausar e auditar automações de CRM para oportunidades, contatos, empresas, tarefas, tags, responsáveis e mensagens. - Seções: Premissas de disparo | Onde configurar | Quando usar | Campos da automação | Entidades e eventos | Estrutura recomendada | Condições | Ações disponíveis - Conteúdo útil: Automações de CRM Automações de CRM executam ações quando uma oportunidade, contato ou empresa é criada ou atualizada por uma origem válida. Elas ajudam a padronizar distribuição, tarefas, tags, mensagens, movimentação de etapa, integração com outros sistemas e acompanhamento comercial. Use automações para reduzir trabalho repetitivo, não para compensar uma rotina mal definida. Antes de ativar qualquer regra, confirme o gatilho, a condição inicial, o registro afetado, o resultado esperado e a forma de auditoria. Premissas de disparo Nem toda criação ou atualização de cadastro inicia uma automação. Para evitar disparos em massa e execuções em cascata, considere estas regras: - importações em... ### Automações sociais para comentários do Instagram - URL: https://agilize.app/docs/configuracao/fluxos-automacoes/automacoes-sociais-instagram - Resumo: Guia completo para criar automações sociais no Instagram, configurar comentários, resposta pública, private reply, prioridade, escopo e fluxo pós-Direct. - Seções: Antes de começar | Onde acessar | Estrutura de uma automação social | Quando executar | Tipo | Prioridade | Escopo | Comentário que ativa a regra - Conteúdo útil: Automações sociais para comentários do Instagram Automações sociais permitem reagir a comentários do Instagram antes de existir uma conversa de Direct aberta. A regra pode registrar o comentário, responder publicamente, enviar uma private reply única e definir o que acontece quando a pessoa responder no Direct. Use este guia para criar regras como: “novo comentário com a palavra preço responde no post e chama a pessoa no Direct”. ::DocsDiagram --- title: "Como a automação social funciona" caption: "O comentário não vira atendimento automaticamente. A conversa normal só começa quando a pessoa responde ao Direct." definition: | flowchart LR A[Comentário no post/Reel] --> B[Regra social ativa]... ### Cadências de envio e follow-up por automação - URL: https://agilize.app/docs/configuracao/fluxos-automacoes/cadencias-envio-follow-up-automacao - Resumo: Como montar cadências de contato no CRM usando condições, mensagens, tarefas, esperas e revalidações antes de cada nova ação. - Seções: Onde configurar | O que inicia uma cadência | Condição inicial | Mensagem ou tarefa | Aguardar prazo | Revalidar antes de continuar | Saídas seguras | Exemplos de cadências - Conteúdo útil: Cadências de envio e follow-up por automação Cadências de envio ajudam a organizar tentativas de contato, lembretes e próximas ações sem depender de controle manual. Na Agilize, elas devem ser criadas como automações de CRM com início claro, pausas entre ações, revalidação antes de cada nova etapa e critérios de encerramento. Use cadências para conduzir oportunidades, contatos ou empresas por uma sequência previsível. Evite usar cadência como disparo indiscriminado: cada mensagem ou tarefa precisa estar ligada ao estágio real do relacionamento. ::DocsDiagram --- title: "Fluxo mínimo de uma cadência" caption: "A cadência só deve continuar quando a condição ainda for verdadeira depois da espe... ### Cenários comuns de fluxos do bot - URL: https://agilize.app/docs/configuracao/fluxos-automacoes/cenarios-comuns-de-fluxos-do-bot - Resumo: Modelos práticos para montar entrada de atendimento, qualificação, geração de oportunidade, distribuição, transferência e encerramento com avaliação. - Seções: Como escolher o cenário | Antes de montar | Entrada de atendimento | Qualificação comercial | Geração de lead ou oportunidade | Distribuição e transferência para atendimento humano | Atendimento fora do horário | Autoatendimento com fallback - Conteúdo útil: Cenários comuns de fluxos do bot Use estes cenários como ponto de partida para desenhar fluxos do bot recorrentes. Eles ajudam a transformar regras de atendimento, vendas e suporte em caminhos claros: entrada, qualificação, decisão, ação, transferência para humano, encerramento e avaliação. Os exemplos não devem ser copiados sem revisão. Antes de publicar, ajuste canal, departamento, funil, origem, tags, variáveis, mensagens, horários e caminhos de erro conforme a rotina real da operação. ::DocsDiagram --- title: "Jornada base de um fluxo do bot" caption: "O fluxo organiza a entrada e a qualificação; quando houver atendimento humano, a conversa chega ao Flow do usuário ou do time." definiti... ### Fluxos do bot - URL: https://agilize.app/docs/configuracao/fluxos-automacoes/fluxos-do-bot - Resumo: Como usar fluxos do bot para automatizar entrada, qualificação, distribuição, geração de registros e encerramento de conversas. - Seções: Quando usar | Onde configurar | Diferença entre fluxo do bot e Flow | Estrutura recomendada | Componentes disponíveis | Organização do canvas | Condições e desvios | Variáveis e dados coletados - Conteúdo útil: Fluxos do bot Fluxos do bot automatizam partes importantes da jornada de conversa: entrada do cliente, triagem, coleta de dados, qualificação, distribuição para atendimento humano, criação de registros no CRM, uso de IA, retomadas por tempo limite e fluxos de encerramento. Eles não substituem a rotina do operador. Quando a conversa precisa de atendimento humano, ela deve chegar ao Flow do responsável ou do time, preservando o histórico coletado pelo bot para que a pessoa continue sem pedir tudo de novo. ::DocsDiagram --- title: "Papel dos fluxos do bot na operação" caption: "O fluxo organiza a entrada e o encaminhamento; o Flow centraliza a execução humana quando a conversa é distribuída."... ### Guia geral de fluxos do bot - URL: https://agilize.app/docs/configuracao/fluxos-automacoes/guia-geral-de-fluxos-do-bot - Resumo: Como planejar, desenhar, testar, publicar e manter fluxos do bot antes de colocar a automação em produção. - Seções: Antes de criar | Criar o fluxo | Estrutura mínima | Início | Nodes e conexões | Mensagens | Condições | Variáveis - Conteúdo útil: Guia geral de fluxos do bot Use este guia para desenhar fluxos do bot com segurança antes de conectá-los a canais reais. O objetivo é transformar uma jornada operacional em um desenho claro, testável e fácil de manter. Um bom fluxo não é apenas uma sequência de mensagens. Ele define entrada, contexto, decisões, variáveis, ações, transferência para atendimento humano, exceções, encerramento e manutenção. ::DocsDiagram --- title: "Ciclo de criação de um fluxo do bot" caption: "Planeje antes de montar, teste antes de vincular ao canal e mantenha snapshots antes de mudanças relevantes." definition: | flowchart LR A[Planejar jornada] --> B[Criar fluxo] B --> C[Montar início e caminhos] C --> D[C... ### Implantação e go-live - URL: https://agilize.app/docs/configuracao/implantacao-go-live - Resumo: Guias para preparar a conta, validar configuração, liberar operação e resolver incidentes iniciais. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Implantação e go-live Use esta seção para preparar a plataforma antes da operação real e para orientar os primeiros ajustes após a liberação. Guias desta seção - Configuração inicial da conta. - Checklist de go-live. - Troubleshooting operacional. Próximo passo Depois da sequência inicial, revise Acessos e segurança. ### Checklist de go-live - URL: https://agilize.app/docs/configuracao/implantacao-go-live/checklist-go-live - Resumo: Lista de validação para liberar a Agilize em produção com canais, usuários, filas, CRM, automações, relatórios e segurança revisados. - Seções: 1. Usuários e acesso | 2. Flow e atendimento | 3. Canais | 4. WhatsApp, sessão e modelos | 5. CRM | 6. Dados | 7. Automações | 8. Fluxos do bot - Conteúdo útil: Checklist de go-live Use este checklist antes de liberar a Agilize para uso real. O objetivo é reduzir risco de canal sem destino, usuário sem permissão, mensagem sem template, automação indevida, fila sem responsável ou relatório sem dados confiáveis. 1. Usuários e acesso - [ ] Usuários principais foram cadastrados. - [ ] Cada usuário está na equipe correta. - [ ] Permissões administrativas estão restritas. - [ ] Operadores conseguem acessar a rotina necessária. - [ ] Gestores conseguem acessar relatórios e monitoramentos. - [ ] Usuários de teste foram removidos ou identificados. - [ ] Contas de pessoas desligadas ou externas não estão ativas. 2. Flow e atendimento - [ ] A equipe entende q... ### Configuração inicial da conta - URL: https://agilize.app/docs/configuracao/implantacao-go-live/configuracao-inicial-da-conta - Resumo: Roteiro recomendado para preparar usuários, equipes, canais, funis, origens, tags, automações e permissões antes de iniciar a operação na Agilize. - Seções: Antes de começar | 1. Comece pela Central de Configurações | 2. Configure permissões, usuários e equipes | 3. Prepare canais e departamentos | 4. Estruture o CRM antes de importar ou criar registros em volume | 5. Configure fluxos e automações por último | 6. Faça testes de ponta a ponta | Checklist de go-live inicial - Conteúdo útil: Configuração inicial da conta A configuração inicial define a base da operação. Antes de liberar a Agilize para o time, prepare acessos, canais, CRM, classificações e automações em uma ordem segura. Isso reduz retrabalho, evita registros sem responsável e facilita a leitura dos relatórios desde o primeiro dia. Use este guia como roteiro de implantação. Os detalhes de cada área podem ser aprofundados nos guias específicos de usuários, canais, funis, fluxos e automações. ::DocsDiagram --- title: "Sequência recomendada" caption: "Ordem segura para preparar a conta antes do go-live." definition: | flowchart LR A[Administradores e permissões] --> B[Usuários e equipes] B --> C[Canais e departamen... ### Troubleshooting operacional - URL: https://agilize.app/docs/configuracao/implantacao-go-live/troubleshooting-operacional - Resumo: Como diagnosticar problemas comuns em mensagens, canais, Flow, CRM, automações, telefonia, relatórios e permissões. - Seções: Antes de começar | Conversa não chegou ao operador | Mensagem não chegou | Lead ou oportunidade não apareceu | Automação não executou | Usuário sem acesso | Canal desconectado | Telefonia sem atendimento - Conteúdo útil: Troubleshooting operacional Use este guia para investigar problemas comuns antes de escalar. A ideia é separar falha de configuração, dado incompleto, permissão, canal desconectado, automação ampla demais ou expectativa incorreta de uso. Antes de começar Confirme: - qual usuário foi afetado; - qual cliente, contato, empresa ou oportunidade está envolvido; - qual canal foi usado; - horário aproximado; - ação esperada; - ação que realmente aconteceu; - se houve mudança recente em canal, permissão, automação, fila ou fluxo. Evite corrigir várias coisas ao mesmo tempo. Faça uma alteração, teste e registre o resultado. Conversa não chegou ao operador | Verifique | O que observar | | --- | --- |... ### Referências de configuração - URL: https://agilize.app/docs/configuracao/referencias - Resumo: Consulta detalhada de nodes de fluxos do bot, automações de CRM e webhooks. - Seções: Referências disponíveis | Próximo passo - Conteúdo útil: Referências de configuração Esta seção é para consulta. Use os guias práticos em Fluxos e automações quando precisar aprender o processo completo; use esta referência quando precisar confirmar o comportamento de um node específico. Referências disponíveis - Nodes de fluxos do bot. - Nodes de automação de CRM. - Nodes de webhooks. Próximo passo Se estiver desenhando um processo novo, comece por Fluxos e automações. ### Nodes de automação de CRM - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm - Resumo: Referência dos nodes usados para criar automações de CRM, tarefas, atribuições, mensagens, webhooks e mudanças de etapa. - Seções: Como usar esta referência | Nodes disponíveis | Guias relacionados - Conteúdo útil: Nodes de automação de CRM Use esta referência para configurar automações de CRM com mais previsibilidade. Cada node representa uma ação, condição ou espera que altera a rotina comercial, cria tarefas, movimenta oportunidades, envia mensagens ou integra dados externos. Automações de CRM devem reduzir trabalho manual sem tirar a rastreabilidade da operação. Antes de ativar uma regra, valide gatilho, condição inicial, entidade afetada e consequência para o time comercial. Importações em massa por planilha/CSV de contatos, oportunidades ou empresas não executam automações de CRM. Também não planeje automações em cascata: uma automação não deve ser tratada como gatilho para outra automação. Use... ### Adicionar / Alterar Tags - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/adicionar-alterar-tags - Resumo: Adiciona novas tags ou limpa as tags da entidade em processamento. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Adicionar / Alterar Tags Adicionar / Alterar Tags é um node de automação de CRM. Sua função principal é: adiciona novas tags ou limpa as tags da entidade em processamento. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a regra de CRM precisar executar essa ação de forma repetível e rastreável. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | --- | | Limpar tags? | clas... ### Aguardar Prazo - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/aguardar-prazo - Resumo: Pausa o fluxo por minutos, horas ou dias antes de continuar. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Aguardar Prazo Aguardar Prazo é um node de automação de CRM. Sua função principal é: pausa o fluxo por minutos, horas ou dias antes de continuar. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o próximo passo depende de prazo, horário, data ou ausência de ação dentro de um limite. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | --- | | Wait Period | controla prazo, es... ### Alterar Usuário Retorno de Chat - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/alterar-usuario-retorno-de-chat - Resumo: Define ou limpa o usuário preferencial de retorno para a sala de chat ligada à entidade. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Alterar Usuário Retorno de Chat Alterar Usuário Retorno de Chat é um node de automação de CRM. Sua função principal é: define ou limpa o usuário preferencial de retorno para a sala de chat ligada à entidade. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a regra de CRM precisar executar essa ação de forma repetível e rastreável. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher |... ### Atribuir/Distribuir Usuário - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/atribuir-distribuir-usuario - Resumo: Atribui a entidade a um usuário específico ou distribui por equipe. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Atribuir/Distribuir Usuário Atribuir/Distribuir Usuário é um node de automação de CRM. Sua função principal é: atribui a entidade a um usuário específico ou distribui por equipe. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa passar a conversa ou responsabilidade para uma pessoa, equipe ou departamento. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | ---... ### Avaliar Condição - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/avaliar-condicao - Resumo: Avalia uma condição sobre a entidade e segue pelo resultado (verdadeiro ou falso). - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Avaliar Condição Avaliar Condição é um node de automação de CRM. Sua função principal é: avalia uma condição sobre a entidade e segue pelo resultado (verdadeiro ou falso). Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o fluxo precisa tomar decisões diferentes conforme dados da conversa, do CRM, do payload ou do contexto. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 1 entrada e possui 2 saídas. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | ---... ### Concluir Conversa - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/concluir-conversa - Resumo: Conclui as salas de conversa associadas ainda abertas para a entidade do fluxo. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Concluir Conversa Concluir Conversa é um node de automação de CRM. Sua função principal é: conclui as salas de conversa associadas ainda abertas para a entidade do fluxo. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a regra de CRM precisar executar essa ação de forma repetível e rastreável. Impacto operacional - Pode enviar mensagem ao cliente; revise variáveis e conteúdo antes de ativar. - Pode finalizar ou interromper a execução da automação/conversa. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Orientaçõ... ### Condição Inicial - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/condicao-inicial - Resumo: Define a condição inicial que dispara o restante do fluxo. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Condição Inicial Condição Inicial é um node de automação de CRM. Sua função principal é: define a condição inicial que dispara o restante do fluxo. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o fluxo precisa tomar decisões diferentes conforme dados da conversa, do CRM, do payload ou do contexto. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 0 entradas e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | --- | | Condições de... ### Criar Item Pipeline - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/criar-item-pipeline - Resumo: Cria um item em um pipeline (com campos, vínculos e atribuição). - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Criar Item Pipeline Criar Item Pipeline é um node de automação de CRM. Sua função principal é: cria um item em um pipeline (com campos, vínculos e atribuição). Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preenche... ### Criar Tarefa/Atividade - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/criar-tarefa-atividade - Resumo: Cria uma atividade vinculada à entidade (com distribuição, data e checklist). - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Criar Tarefa/Atividade Criar Tarefa/Atividade é um node de automação de CRM. Sua função principal é: cria uma atividade vinculada à entidade (com distribuição, data e checklist). Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Cria tarefa ou atividade no CRM e pode definir responsável, data, quadro e checklist. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de confi... ### Enviar Conversões - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/enviar-conversoes - Resumo: Envia eventos de conversão (Meta CAPI e Google Enhanced Conversions) com deduplicação por registro. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Enviar Conversões Enviar Conversões é um node de automação de CRM. Sua função principal é: envia eventos de conversão (Meta CAPI e Google Enhanced Conversions) com deduplicação por registro. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a regra de CRM precisar executar essa ação de forma repetível e rastreável. Impacto operacional - Pode enviar mensagem ao cliente; revise variáveis e conteúdo antes de ativar. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | ---... ### Enviar SMS - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/enviar-sms - Resumo: Envia SMS e registra timeline (inclui vinculação ao pipeline quando aplicável). - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Enviar SMS Enviar SMS é um node de automação de CRM. Sua função principal é: envia SMS e registra timeline (inclui vinculação ao pipeline quando aplicável). Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o fluxo precisa comunicar algo ao cliente usando mensagem, mídia, campanha, lista ou template aprovado. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | --- | | Conteu... ### Enviar Webhook HTTP - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/enviar-webhook-http - Resumo: Envia, de forma assíncrona, os dados da entidade para uma URL (webhook). - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Enviar Webhook HTTP Enviar Webhook HTTP é um node de automação de CRM. Sua função principal é: envia, de forma assíncrona, os dados da entidade para uma URL (webhook). Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa consultar ou notificar um sistema externo durante o fluxo. Impacto operacional - Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | --- | | UR... ### Gerar Entidade - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/gerar-entidade - Resumo: Cria ou atualiza contato, empresa ou oportunidade no CRM. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Gerar Entidade Gerar Entidade é um node de automação de CRM. Sua função principal é: cria ou atualiza contato, empresa ou oportunidade no CRM. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | --- |... ### Lead Ganhou ou Perdeu - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/lead-ganhou-ou-perdeu - Resumo: Marca uma oportunidade como ganha ou perdida. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Lead Ganhou ou Perdeu Lead Ganhou ou Perdeu é um node de automação de CRM. Sua função principal é: marca uma oportunidade como ganha ou perdida. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | ---... ### Mensagem WhatsApp c/ Fluxo (Template) - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/mensagem-whatsapp-c-fluxo-template - Resumo: Envia template do WhatsApp e cria rotas pelos botões do template. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Mensagem WhatsApp c/ Fluxo (Template) Mensagem WhatsApp c/ Fluxo (Template) é um node de automação de CRM. Sua função principal é: envia template do WhatsApp e cria rotas pelos botões do template. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o fluxo precisa comunicar algo ao cliente usando mensagem, mídia, campanha, lista ou template aprovado. Impacto operacional Entradas e saídas Este node recebe 1 entrada e possui saídas dinâmicas. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | --- | | Telefone | campo de config... ### Mensagem WhatsApp (Template) - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/mensagem-whatsapp-template - Resumo: Envia um template de WhatsApp para a entidade considerando seus dados. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Mensagem WhatsApp (Template) Mensagem WhatsApp (Template) é um node de automação de CRM. Sua função principal é: envia um template de WhatsApp para a entidade considerando seus dados. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o fluxo precisa comunicar algo ao cliente usando mensagem, mídia, campanha, lista ou template aprovado. Impacto operacional - Pode enviar mensagem ao cliente; revise variáveis e conteúdo antes de ativar. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | C... ### Mover Etapa Pipeline - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/mover-etapa-pipeline - Resumo: Move um item de pipeline para outra etapa (respeita validações). - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Mover Etapa Pipeline Mover Etapa Pipeline é um node de automação de CRM. Sua função principal é: move um item de pipeline para outra etapa (respeita validações). Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preenc... ### Operação em Lista de Transmissão - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/operacao-em-lista-de-transmissao - Resumo: Adiciona ou remove a entidade de uma lista de transmissão. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Operação em Lista de Transmissão Operação em Lista de Transmissão é um node de automação de CRM. Sua função principal é: adiciona ou remove a entidade de uma lista de transmissão. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o fluxo precisa comunicar algo ao cliente usando mensagem, mídia, campanha, lista ou template aprovado. Impacto operacional - Cria, busca ou atualiza entidades como lead, contato ou empresa. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | |... ### Setar Funil/Etapa Lead - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/setar-funil-etapa-lead - Resumo: Altera o funil e/ou a etapa de uma oportunidade (lead). - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Setar Funil/Etapa Lead Setar Funil/Etapa Lead é um node de automação de CRM. Sua função principal é: altera o funil e/ou a etapa de uma oportunidade (lead). Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | ---... ### Vincular Sala (Pipeline) - URL: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/vincular-sala-pipeline - Resumo: Vincula uma sala (Messenger) a um item do pipeline e cria contexto da sala para exibição. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Vincular Sala (Pipeline) Vincular Sala (Pipeline) é um node de automação de CRM. Sua função principal é: vincula uma sala (Messenger) a um item do pipeline e cria contexto da sala para exibição. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode executar uma ação no CRM ou alterar a sequência da automação. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configur... ### Nodes de fluxos do bot - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot - Resumo: Referência dos nodes usados nos fluxos do bot para mensagens, condições, transferências, IA, geração de entidades e encerramento. - Seções: Como usar esta referência | Controle do fluxo | Mensagens | Coleta de dados | Condições | Dados e integrações | Guias relacionados - Conteúdo útil: Nodes de fluxos do bot Use esta referência para escolher e configurar os nodes do builder de fluxos do bot. Cada página explica o objetivo do node, quando usar, campos principais, entradas, saídas, exemplos, riscos e uma forma prática de testar antes de publicar. Os nodes afetam diretamente a experiência do cliente, o roteamento da conversa, os dados enviados ao CRM e o trabalho do operador no Flow. Antes de ativar um fluxo em produção, valide caminho principal, caminho de erro, fallback e saída para atendimento humano quando fizer sentido. Como usar esta referência - Comece pelo guia geral de fluxos do bot para entender a estrutura do fluxo. - Escolha o node pelo objetivo: mensagem, coleta... ### Adicionar / Alterar Tags - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/adicionar-alterar-tags - Resumo: Adiciona novas tags à sala de conversa ou limpa as atuais. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Adicionar / Alterar Tags Adiciona novas tags à sala de conversa ou limpa as atuais. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa alterar dados da conversa, consultar sistemas, criar registros ou expor informações ao operador. Campos de configuração - Tags: selecione as tags desejadas. - Limpar tags?: remove as existentes antes de aplicar as novas. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: fluxo segue após a atualização das tags. Exemplo prático Use Adicionar / Alterar Tags quando o fluxo precisar executar este c... ### Adicionar Tags no Detalhamento - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/adicionar-tags-no-detalhamento - Resumo: Adiciona ou limpa tags no detalhamento da conversa atual. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Adicionar Tags no Detalhamento Adiciona ou limpa tags no detalhamento da conversa atual. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa alterar dados da conversa, consultar sistemas, criar registros ou expor informações ao operador. Campos de configuração - Tags: selecione as tags do detalhamento. - Limpar tags?: remove as tags existentes do detalhamento antes de aplicar as novas. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: fluxo segue após a atualização das tags. Exemplo prático Use Adicionar Tags no Detalhamento q... ### Agente de Inteligência Artificial - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/agente-de-inteligencia-artificial - Resumo: Encaminha mensagens para um agente de IA e segue a intenção identificada. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Agente de Inteligência Artificial Encaminha mensagens para um agente de IA e segue a intenção identificada. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando a intenção do cliente precisa ser interpretada com IA antes de decidir o próximo caminho. - Aplique em triagens abertas, captura de variáveis e roteamento por intenção. Campos de configuração - Agente de IA: agente previamente cadastrado. - Modelo de IA: selecione o modelo (ex.: gpt-4o-mini). - Habilitar Transcrição de Áudio: ativa transcrição quando aplicável. - Manter contexto entre conversas: persiste a thread para r... ### Ativar Debug / Inspeção - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/ativar-debug-inspecao - Resumo: Ativa o modo Debug / Inspeção do fluxo para uma sala específica. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Ativar Debug / Inspeção Ativa o modo Debug / Inspeção do fluxo para uma sala específica. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa controlar início, encerramento, transferência, timeout ou troca de jornada. Campos de configuração - Sala alvo (roomId): selecione a sala em que o Debug / Inspeção deve ser ativado. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: continua o fluxo normalmente. Exemplo prático Use Ativar Debug / Inspeção quando o fluxo precisar executar este comportamento: ativa o modo Debug / Inspeção do... ### Ativar Fluxo de Encerramento - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/ativar-fluxo-de-encerramento - Resumo: Habilita um fluxo específico para ser executado no encerramento do atendimento. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Ativar Fluxo de Encerramento Habilita um fluxo específico para ser executado no encerramento do atendimento. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use antes de transferir ou manter atendimento humano quando a conversa precisa acionar uma rotina no encerramento. - Aplique em jornadas que devem coletar avaliação, classificar atendimento ou executar regra final. Campos de configuração - Fluxo: selecione o fluxo de encerramento. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: segue o fluxo atual; a configuração afeta o encerramento futuro. E... ### Chamada em API Externa - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/chamada-em-api-externa - Resumo: Executa um método de integração e segue pela rota de sucesso, falha ou limite. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Chamada em API Externa Executa um método de integração e segue pela rota de sucesso, falha ou limite. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa chamar uma integração cadastrada e decidir o caminho pelo retorno. - Aplique para consultar dados, validar informações ou executar operações externas. Campos de configuração - Plataforma e Método: selecione a integração e a operação a executar. - Máx. Tentativas: repete enquanto não atender à regra configurada. - Variável Saída: armazena o retorno. - Dados de Entrada (DE/PARA): mapeamento de campos do método.... ### Coletar Pesquisa de Satisfação - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/coletar-pesquisa-de-satisfacao - Resumo: Solicita uma nota de satisfação do cliente e registra a resposta. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Coletar Pesquisa de Satisfação Solicita uma nota de satisfação do cliente e registra a resposta. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa perguntar, capturar, validar ou apresentar dados coletados do cliente. Campos de configuração - Mensagem: texto de solicitação; aceita variáveis. - Modo de Entrada: nota textual (1–5), 3 botões (1/3/5) ou 5 botões (1–5). - Solicitar Máx. Vezes: número de tentativas. - Desabilitar mensagem de agradecimento: remove a confirmação enviada após registrar a nota. - Botões de Avaliação: rótulos personalizados para os botõ... ### Condicionais por Tag - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/condicionais-por-tag - Resumo: Roteia a conversa conforme tags (sala/contato/empresa/lead) por prioridade. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Condicionais por Tag Roteia a conversa conforme tags (sala/contato/empresa/lead) por prioridade. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa escolher um caminho com base em horário, tag, texto, canal ou variável. Campos de configuração - Buscar tags em: define onde as tags serão avaliadas (padrão: Sala de Conversa). - Saídas dinâmicas: para cada saída, selecione a tag que ativará aquela rota. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: usa saídas dinâmicas ou rotas especiais, conforme a configuração. - Uma saída para cada tag configurada.... ### Condicional Conjunto de Datas - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/condicional-conjunto-de-datas - Resumo: Verifica se a data/hora atual está dentro de pelo menos uma das regras selecionadas. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Condicional Conjunto de Datas Verifica se a data/hora atual está dentro de pelo menos uma das regras selecionadas. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa escolher um caminho com base em horário, tag, texto, canal ou variável. Campos de configuração - Regras de Data: selecione uma ou mais regras previamente criadas. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 2 saídas. - Dentro das regras: quando a data e hora atuais atendem a alguma regra selecionada. - Fora das regras: quando nenhuma regra é atendida. Exemplo prático Em feriad... ### Condicional de Tempo - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/condicional-de-tempo - Resumo: Direciona o fluxo conforme faixas de horário e dias da semana. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Condicional de Tempo Direciona o fluxo conforme faixas de horário e dias da semana. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa escolher um caminho com base em horário, tag, texto, canal ou variável. Campos de configuração - Condições: adicione horários (início e fim) e dias da semana. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 2 saídas. - Dentro do horário: quando a data e hora atuais entram em alguma faixa configurada. - Fora do horário: quando nenhuma faixa é atendida. Exemplo prático Durante o horário comercial, transfira para... ### Conectar Fluxo - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/conectar-fluxo - Resumo: Alterna a execução para outro fluxo de bot. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Conectar Fluxo Alterna a execução para outro fluxo de bot. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando a jornada precisa continuar em outro fluxo já estruturado. - Evite repetir blocos grandes dentro do mesmo canvas. Campos de configuração - Fluxo: selecione o fluxo de destino. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: usa saídas dinâmicas ou rotas especiais, conforme a configuração. - Sem saídas. A execução continua no fluxo escolhido. Exemplo prático Use Conectar Fluxo quando o fluxo precisar executar este comportamento: alterna a execução para outro... ### Destacar/Fixar Variáveis - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destacar-fixar-variaveis - Resumo: Exibe e fixa variáveis importantes para o operador durante o atendimento. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Destacar/Fixar Variáveis Exibe e fixa variáveis importantes para o operador durante o atendimento. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa alterar dados da conversa, consultar sistemas, criar registros ou expor informações ao operador. Campos de configuração - Variável Origem (src): caminho da variável a exibir. - Nome de Exibição (label): como o valor aparecerá para o operador. - Variável de Destino (dst): onde salvar o valor (opcional). - Transformação: expressão de transformação (JSONata) aplicada ao valor. Entradas e saídas - Entradas: recebe 1... ### Destino em Tempo Limite - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destino-em-tempo-limite - Resumo: Cria uma bifurcação: executar agora ou seguir para rota de tempo limite após prazo. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Destino em Tempo Limite Cria uma bifurcação: executar agora ou seguir para rota de tempo limite após prazo. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando uma resposta ou ação precisa ter prazo máximo. - Aplique em lembretes, escalonamentos e fluxos que não podem ficar parados indefinidamente. Campos de configuração - Tempo até timeout (hh:mm): prazo antes de acionar a segunda rota. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 2 saídas. - Executar nó: caminho normal antes do tempo limite. - Executar tempo limite: caminho usado quando o prazo expira. Ex... ### Destino por Conta WhatsApp - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destino-por-conta-whatsapp - Resumo: Roteia a conversa conforme a conta do WhatsApp integrada (número) que originou a conversa. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Destino por Conta WhatsApp Roteia a conversa conforme a conta do WhatsApp integrada (número) que originou a conversa. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa escolher um caminho com base em horário, tag, texto, canal ou variável. Campos de configuração - Saídas dinâmicas: adicione rotas e selecione a conta do WhatsApp para cada saída. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: usa saídas dinâmicas ou rotas especiais, conforme a configuração. - Uma saída para cada conta de WhatsApp configurada. - Fluxo padrão: usada para outros canais... ### Destino por Origem do Canal - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destino-por-origem-do-canal - Resumo: Roteia a conversa conforme o tipo de canal de origem (LiveChat, WhatsApp com telefone de origem, WhatsApp sem telefone, Facebook Page, Instagram DM). - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Destino por Origem do Canal Roteia a conversa conforme o tipo de canal de origem (LiveChat, WhatsApp com telefone de origem, WhatsApp sem telefone, Facebook Page, Instagram DM). Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa escolher um caminho com base em horário, tag, texto, canal ou variável. Campos de configuração - Saídas dinâmicas: adicione rotas e selecione o tipo de canal para cada saída. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: usa saídas dinâmicas ou rotas especiais, conforme a configuração. - Uma saída para cada origem de canal... ### Destino por Valor de Variável - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/destino-por-valor-de-variavel - Resumo: Roteia o fluxo conforme o valor de uma variável (telefone, nome, e-mail ou variável do fluxo). - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Destino por Valor de Variável Roteia o fluxo conforme o valor de uma variável (telefone, nome, e-mail ou variável do fluxo). Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa escolher um caminho com base em horário, tag, texto, canal ou variável. Campos de configuração - Origem da variável: Telefone, Nome, E-mail ou variável do fluxo. - Tipo de correspondência: Exata, Inicia com, Termina com, Contém, Não contém, Não inicia com, Não termina com. - Saídas dinâmicas: adicione rotas para cada valor esperado. Entradas e saídas - Entradas: recebe 1 entrada. - Saída... ### Finalizar Atendimento - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/finalizar-atendimento - Resumo: Encerra a conversa atual e finaliza o atendimento. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Finalizar Atendimento Encerra a conversa atual e finaliza o atendimento. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo deve encerrar a conversa sem seguir para outro atendimento. - Use depois de mensagens finais, avaliações ou confirmações necessárias. Campos de configuração - Não há configurações. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: usa saídas dinâmicas ou rotas especiais, conforme a configuração. - Sem saídas. É um nó terminal. Exemplo prático Use Finalizar Atendimento quando o fluxo precisar executar este comportamento: encerra a conversa... ### Fluxo por Textos/Palavras - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/fluxo-por-textos-palavras - Resumo: Cria rotas a partir de palavras-chave ou expressões (regex) na mensagem. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Fluxo por Textos/Palavras Cria rotas a partir de palavras-chave ou expressões (regex) na mensagem. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa escolher um caminho com base em horário, tag, texto, canal ou variável. Campos de configuração - Saídas dinâmicas: adicione fluxos e defina o termo/expressão correspondente. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: usa saídas dinâmicas ou rotas especiais, conforme a configuração. - Uma saída para cada texto, palavra ou expressão configurada. - Fluxo padrão: usada quando nenhuma regra corresponde.... ### Fluxos por Variável - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/fluxos-por-variavel - Resumo: Direciona o fluxo conforme o valor de uma variável. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Fluxos por Variável Direciona o fluxo conforme o valor de uma variável. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa escolher um caminho com base em horário, tag, texto, canal ou variável. Campos de configuração - Variável avaliada: nome da variável a comparar. - Saídas dinâmicas: adicione rotas e defina o valor de comparação para cada uma. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: usa saídas dinâmicas ou rotas especiais, conforme a configuração. - Uma saída para cada valor configurado. - Fluxo padrão: usada quando a variável não correspo... ### Gerar Entidade - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/gerar-entidade - Resumo: Cria ou atualiza contato, empresa ou oportunidade a partir da conversa. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Gerar Entidade Cria ou atualiza contato, empresa ou oportunidade a partir da conversa. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa alterar dados da conversa, consultar sistemas, criar registros ou expor informações ao operador. Campos de configuração - Tipo de Entidade: contato, empresa ou oportunidade. - Nome: pode usar variáveis da conversa. - Tags: lista de tags a associar. - Para oportunidade: funil, etapa, origem e temperatura. - Responsável: usuário, equipe ou atribuir no momento da transferência. - Atribuir como criação/desenvolvimento (SDR): mar... ### Gerar Lead - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/gerar-lead - Resumo: Cria uma oportunidade (lead) a partir da conversa em andamento. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Gerar Lead Cria uma oportunidade (lead) a partir da conversa em andamento. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa alterar dados da conversa, consultar sistemas, criar registros ou expor informações ao operador. Campos de configuração - Nome: pode usar variáveis (padrão: nome da conversa). - Tags: tags do lead. - Funil e Origem: selecione o funil e a origem. - Responsável: usuário, equipe ou atribuir na transferência. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: segue o fluxo após a criação. Exemplo prático Cr... ### Início - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/inicio - Resumo: Ponto inicial do fluxo de atendimento por chat. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Início Ponto inicial do fluxo de atendimento por chat. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use no início de todo fluxo de atendimento por bot. - Conecte diretamente ao primeiro passo real da jornada. Campos de configuração - Não há configurações. Entradas e saídas - Entradas: não recebe entrada; é o ponto inicial do fluxo. - Saídas: possui 1 saída. - 1 saída: conecte ao primeiro passo desejado do fluxo. Exemplo prático Inicie um fluxo com uma mensagem de boas-vindas e conecte a primeira pergunta ou condição logo depois. Boas práticas e riscos comuns - Evite deixar caminho... ### Mensagem com Mídia - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-c-midia - Resumo: Envia uma mensagem com mídia (imagem, áudio, vídeo ou documento) e legenda opcional. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Mensagem com Mídia Envia uma mensagem com mídia (imagem, áudio, vídeo ou documento) e legenda opcional. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa enviar conteúdo ao cliente por texto, mídia ou template. Campos de configuração - Arquivo de Mídia: selecione o arquivo a enviar. - Legenda (opcional): texto que acompanha a mídia; aceita variáveis. - Atrasar Envio (segundos): pequena espera antes do envio. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: segue o fluxo após o envio. Exemplo prático Envie um PDF com polític... ### Mensagem com Opções - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-c-opcoes - Resumo: Envia mensagem com botões e direciona o fluxo conforme a opção escolhida. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Mensagem com Opções Envia mensagem com botões e direciona o fluxo conforme a opção escolhida. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa perguntar, capturar, validar ou apresentar dados coletados do cliente. Campos de configuração - Mensagem: texto de apresentação; aceita variáveis. - Nome Variável Saída: variável para salvar a opção escolhida. - Fixar dado na interface do operador: exibe a informação. - Sobrescrever Var. Saída por opção: define valores específicos a salvar para cada saída. - Sub-título nas Opções (WhatsApp): texto complementar por opç... ### Mensagem com Opções de Variáveis - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-com-opcoes-de-variaveis - Resumo: Gera botões a partir de uma lista em variável e salva a opção escolhida. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Mensagem com Opções de Variáveis Gera botões a partir de uma lista em variável e salva a opção escolhida. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa perguntar, capturar, validar ou apresentar dados coletados do cliente. Campos de configuração - Texto Solicitação: mensagem com instruções; aceita variáveis. - Variável com Lista: nome/caminho da variável que contém a lista. - Template Botão: rótulo de cada opção. - Variável de Saída: onde salvar a opção escolhida. - Fixar dado na interface do operador: exibe a informação. - Regex Itens Padrão (Entrada/For... ### Mensagem de Template WhatsApp - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-de-template-wa - Resumo: Envia uma mensagem de template do WhatsApp previamente aprovado. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Mensagem de Template WhatsApp Envia uma mensagem de template do WhatsApp previamente aprovado. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa enviar conteúdo ao cliente por texto, mídia ou template. Campos de configuração - Telefone (WhatsApp): número remetente configurado. - Template: modelo aprovado a ser enviado. - Variáveis do Template: mapeamento para preencher o cabeçalho/corpo. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: segue o fluxo após o envio. Exemplo prático Envie um template aprovado com variáveis de n... ### Mensagem Simples - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-simples - Resumo: Envia uma mensagem de texto simples; opcionalmente aguarda resposta. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Mensagem Simples Envia uma mensagem de texto simples; opcionalmente aguarda resposta. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa enviar conteúdo ao cliente por texto, mídia ou template. Campos de configuração - Mensagem: texto enviado; aceita variáveis do fluxo. - Aguardar Resposta?: quando ativo, pausa até o cliente responder. - Atrasar Envio (segundos): pequena espera antes do envio. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: segue o fluxo após envio (ou após a resposta, se aguardando). Exemplo prático Envie... ### Mensagem Texto de Variáveis - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/mensagem-texto-de-variaveis - Resumo: Envia ao cliente o conteúdo de uma variável (texto ou lista). - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Mensagem Texto de Variáveis Envia ao cliente o conteúdo de uma variável (texto ou lista). Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa enviar conteúdo ao cliente por texto, mídia ou template. Campos de configuração - Nome da Variável: caminho ou nome da variável. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: segue após o envio. Exemplo prático Use Mensagem Texto de Variáveis quando o fluxo precisar executar este comportamento: envia ao cliente o conteúdo de uma variável (texto ou lista). Boas práticas e riscos comun... ### Requisição HTTP (Delegar) - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/requisicao-http-delegar - Resumo: Delegue o processamento do fluxo para um endpoint HTTP próprio. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Requisição HTTP (Delegar) Delegue o processamento do fluxo para um endpoint HTTP próprio. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando uma API própria precisa decidir o próximo comportamento da conversa. - Aplique em regras complexas, integrações customizadas e jornadas que precisam manter estado fora do builder. Campos de configuração - URL Requisição: endpoint que receberá a requisição. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: segue o fluxo após o retorno do seu endpoint. Exemplo prático Envie a mensagem atual para uma API p... ### Requisição HTTP (Webhook) - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/requisicao-http-webhook - Resumo: Envia o estado atual da conversa para uma URL (webhook) sem bloquear o fluxo. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Requisição HTTP (Webhook) Envia o estado atual da conversa para uma URL (webhook) sem bloquear o fluxo. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando um sistema externo precisa ser avisado sobre um evento do fluxo. - Aplique para auditoria, logs, notificações e integrações assíncronas. Campos de configuração - URL Requisição: endereço do webhook. Entradas e saídas - Entradas: recebe 1 entrada. - Saídas: possui 1 saída. - 1 saída: o fluxo segue adiante sempre. Exemplo prático Notifique um sistema externo quando o cliente chegar a uma etapa crítica, sem alterar o caminho d... ### Solicitar Informação Textual - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/solicitar-informacao-textual - Resumo: Solicita um texto ao cliente e salva o valor em uma variável. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Solicitar Informação Textual Solicita um texto ao cliente e salva o valor em uma variável. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o fluxo precisa perguntar, capturar, validar ou apresentar dados coletados do cliente. Campos de configuração - Mensagem de Solicitação: texto enviado; aceita variáveis. - Nome Variável Saída: onde salvar o valor. - Regex de Limpeza: expressão para limpar o texto (ex.: remover caracteres não numéricos). - Função de Validação: valida formatos comuns (CPF, CNPJ, e-mail, data). - Mensagem para Erro de Validação: dica enviada quando o valor... ### Transferir Departamento - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/transferir-departamento - Resumo: Transfere a conversa para um departamento específico. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Transferir Departamento Transfere a conversa para um departamento específico. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando o bot precisa transferir a conversa para uma equipe humana. - Aplique depois de qualificação, triagem ou identificação de necessidade específica. Campos de configuração - Departamento: destino da transferência. - Aviso de Transferência?: envia uma mensagem antes de transferir. - Mensagem de Transferência: texto enviado ao cliente (opcional). - Setar usuário preferencial de retorno?: registra preferência para próximos retornos. Entradas e saídas - En... ### Transferir Departamento em Timeout - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/transferir-departamento-em-timeout - Resumo: Transfere a conversa para um departamento após um tempo de espera. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Transferir Departamento em Timeout Transfere a conversa para um departamento após um tempo de espera. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando a transferência deve acontecer apenas se uma condição de tempo for atingida. - Aplique para contingência de atendimento e proteção contra conversas paradas. Campos de configuração - Departamento: destino da transferência. - Tempo limite até transferência: período em minutos. - Aviso de Transferência? e Mensagem de Transferência: comunicação ao cliente (opcional). - Setar usuário preferencial de retorno?: registra preferência... ### Verifica e Transfere Usuário Preferência - URL: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/verifica-e-transfere-usuario-preferencia - Resumo: Transfere para usuário preferencial da sala ou do CRM. - Seções: Quando usar | Campos de configuração | Entradas e saídas | Exemplo prático | Boas práticas e riscos comuns | Como testar | Guias relacionados - Conteúdo útil: Verifica e Transfere Usuário Preferência Transfere para usuário preferencial da sala ou do CRM. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções. Quando usar - Use quando a conversa deve tentar voltar para o usuário preferencial antes de cair em outro caminho. - Aplique em operações com carteira, dono comercial ou continuidade de atendimento. Campos de configuração - Tempo até timeout (hh:mm): janela de tolerância antes da rota de tempo limite. - Considerar CRM: habilita a busca por usuário em Sala / Lead / Contato / Empresa. - Prioridade: selecione a ordem entre Sala, Lead, Contato e Empresa (padrã... ### Nodes de webhooks - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks - Resumo: Referência dos nodes usados em webhooks para receber payloads, criar entidades, buscar registros, mapear usuários, criar tarefas e atualizar contexto. - Seções: Como usar esta referência | Nodes disponíveis | Guias relacionados - Conteúdo útil: Nodes de webhooks Use esta referência para transformar eventos recebidos por webhook em ações operacionais na Agilize. Os nodes permitem inspecionar o payload, criar ou localizar entidades no CRM, mapear responsáveis e continuar o fluxo com contexto estruturado. Webhooks conectam sistemas externos à operação. Uma configuração correta evita duplicidades, perda de origem, tarefas sem dono e leads criados sem etapa, responsável ou contexto suficiente. Como usar esta referência - Comece pelo guia geral da área antes de configurar nodes isolados. - Abra a página do node para entender campos, impacto operacional e cuidados. - Teste em ambiente controlado antes de ativar em fluxos usados por clien... ### Alterar Campo Adicional - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/alterar-campo-adicional - Resumo: Atualiza campos adicionais de lead, contato ou empresa usando uma entidade salva no contexto. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Alterar Campo Adicional Alterar Campo Adicional é um node de webhook. Sua função principal é: atualiza campos adicionais de lead, contato ou empresa usando uma entidade salva no contexto. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o evento recebido por webhook precisar ser interpretado, enriquecido ou convertido em ação na Agilize. Impacto operacional - Cria, busca ou atualiza entidades como lead, contato ou empresa. - Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout. - Lê ou grava variáveis de contexto que podem ser usadas pelos próximos nodes. Entradas e saídas Este node recebe 1 entrad... ### Alterar Etapa do Lead - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/alterar-etapa-do-lead - Resumo: Altera a etapa do lead salvo no contexto do webhook. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Alterar Etapa do Lead Alterar Etapa do Lead é um node de webhook. Sua função principal é: altera a etapa do lead salvo no contexto do webhook. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. - Cria, busca ou atualiza entidades como lead, contato ou empresa. - Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout. - Lê ou grava variáveis de contexto que podem ser usadas pelos próximos no... ### Buscar Entidade - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/buscar-entidade - Resumo: Busca uma entidade do CRM e a salva no contexto para uso em nós posteriores. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Buscar Entidade Buscar Entidade é um node de webhook. Sua função principal é: busca uma entidade do CRM e a salva no contexto para uso em nós posteriores. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. - Lê ou grava variáveis de contexto que podem ser usadas pelos próximos nodes. Entradas e saídas Este node recebe 1 entrada e possui 2 saídas. Quando houver mais de uma saída, nomeie os caminhos de forma clara para f... ### Criar Tarefa/Atividade - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/criar-tarefa-atividade - Resumo: Cria uma atividade no CRM reaproveitando entidades e usuário já resolvidos no webhook. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Criar Tarefa/Atividade Criar Tarefa/Atividade é um node de webhook. Sua função principal é: cria uma atividade no CRM reaproveitando entidades e usuário já resolvidos no webhook. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Cria tarefa ou atividade no CRM e pode definir responsável, data, quadro e checklist. - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. - Cria, busca ou atualiza entidades como lead, contato ou empresa. - Executa chamada externa ou webhook;... ### Debug / Inspeção de Evento - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/debug-inspecao-de-evento - Resumo: Inspeciona o evento recebido (payload/contexto) e auxilia no teste do webhook. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Debug / Inspeção de Evento Debug / Inspeção de Evento é um node de webhook. Sua função principal é: inspeciona o evento recebido (payload/contexto) e auxilia no teste do webhook. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use em fase de teste para entender payload, contexto e variáveis antes de publicar o fluxo. Impacto operacional - Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout. Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | ---... ### Fluxos por Valor - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/fluxos-por-valor - Resumo: Direciona o fluxo conforme o valor de um campo do payload/contexto. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Fluxos por Valor Fluxos por Valor é um node de webhook. Sua função principal é: direciona o fluxo conforme o valor de um campo do payload/contexto. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o evento recebido por webhook precisar ser interpretado, enriquecido ou convertido em ação na Agilize. Impacto operacional - Pode transformar dados recebidos por webhook em ações no CRM ou em variáveis de contexto para os próximos nodes. Entradas e saídas Este node recebe 1 entrada e possui 0 saídas. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Co... ### Gerar Entidade - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/gerar-entidade - Resumo: Cria contato, empresa ou oportunidade usando dados do webhook. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Gerar Entidade Gerar Entidade é um node de webhook. Sua função principal é: cria contato, empresa ou oportunidade usando dados do webhook. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. Impacto operacional - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. - Cria, busca ou atualiza entidades como lead, contato ou empresa. - Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout. - Lê ou grava variáveis de contexto que podem ser usadas pelos próximos nodes.... ### Início do Fluxo - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/inicio-do-fluxo - Resumo: Ponto inicial do fluxo de Webhook/Integração. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Início do Fluxo Início do Fluxo é um node de webhook. Sua função principal é: ponto inicial do fluxo de Webhook/Integração. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use como ponto de partida do fluxo. Ele deve conduzir para a primeira decisão, mensagem ou ação real. Impacto operacional - Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout. Entradas e saídas Este node recebe 0 entradas e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Orientações do node O que faz - Marca o início do fluxo de processamento do Webhook. - Exibe/permit... ### Mapear Usuário - URL: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/mapear-usuario - Resumo: Resolve um usuário a partir de um valor do webhook, por e-mail ou de/para. - Seções: Quando usar | Impacto operacional | Entradas e saídas | Campos de configuração | Orientações do node | Boas práticas | Como validar | Próximos passos - Conteúdo útil: Mapear Usuário Mapear Usuário é um node de webhook. Sua função principal é: resolve um usuário a partir de um valor do webhook, por e-mail ou de/para. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. Quando usar Use quando o evento recebido por webhook precisar ser interpretado, enriquecido ou convertido em ação na Agilize. Impacto operacional - Lê ou grava variáveis de contexto que podem ser usadas pelos próximos nodes. Entradas e saídas Este node recebe 1 entrada e possui 2 saídas. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. Campos de configuração | Campo | Como preencher | | --- | --- | | Va... ### Relatórios e governança - URL: https://agilize.app/docs/configuracao/relatorios-governanca - Resumo: Guias para configurar painéis de BI, padronizar indicadores e manter permissões de edição sem misturar operação com governança. - Seções: Guias desta seção | Como dividir operação e configuração | Próximo passo - Conteúdo útil: Relatórios e governança Esta seção trata da configuração que sustenta o BI da Agilize: quais painéis existem, quais indicadores são oficiais, quem pode manter os itens e como evitar leituras divergentes da operação. Use a área operacional de Relatórios e BI para consultar indicadores, criar itens e escolher fontes de dados. Use esta seção quando a decisão for de governança: padronização, manutenção, permissões, painéis recorrentes e revisão. Guias desta seção - Configurar painéis de BI. - Padronizar indicadores da operação. - Permissões e manutenção de painéis. Como dividir operação e configuração | Necessidade | Onde consultar | | --- | --- | | Entender o que medir na rotina. | Relatórios... ### Configurar painéis de BI - URL: https://agilize.app/docs/configuracao/relatorios-governanca/configurar-paineis-bi - Resumo: Como estruturar painéis de BI na Agilize, adicionando itens de relatório, organizando layout, período global, modo foco e rotina de revisão. - Seções: Antes de começar | Estrutura da tela | Fluxo recomendado | Criar ou selecionar um painel | Adicionar relatórios ao painel | Organizar layout | Usar período global | Usar modo foco - Conteúdo útil: Configurar painéis de BI Painéis de BI agrupam itens de relatório em uma visão recorrente de gestão. Eles são úteis para reuniões, acompanhamento diário, análise semanal e monitoramento de metas da operação. Use este guia para configurar painéis em https://my.agilize.app/report/ sem misturar relatórios de consulta pontual com painéis oficiais. Acesso pela tela: barra superior Relatórios > Relatórios e Insights. Pela sidebar lateral, troque para Hub/CRM e abra Relatórios. Antes de começar Defina a finalidade do painel antes de adicionar gráficos: - Painel de operação diária: mostra filas, pendências, conversas, tarefas e gargalos de hoje. - Painel comercial: mostra oportunidades, etapas, ori... ### Padronizar indicadores da operação - URL: https://agilize.app/docs/configuracao/relatorios-governanca/padronizar-indicadores-operacao - Resumo: Como definir indicadores oficiais, nomes, fontes, filtros, períodos e critérios de leitura para que a operação use o BI com consistência. - Seções: O que deve virar padrão | Modelo de definição de indicador | Regras de nome | Escolha da fonte oficial | Filtros e períodos oficiais | Exemplo de padrão | Checklist de governança | Próximo passo - Conteúdo útil: Padronizar indicadores da operação Padronizar indicadores evita que cada gestor leia a operação de um jeito. A Agilize permite montar relatórios flexíveis, mas a governança precisa definir quais métricas são oficiais, quais fontes devem ser usadas e como cada indicador deve ser interpretado. Use este guia antes de publicar painéis recorrentes em https://my.agilize.app/report/. Acesso pela tela: barra superior Relatórios > Relatórios e Insights. Pela sidebar lateral, troque para Hub/CRM e abra Relatórios. O que deve virar padrão Nem todo relatório precisa ser oficial. Padronize os indicadores que aparecem em reunião, metas, acompanhamento de equipe ou decisão comercial. | Tipo de indicador |... ### Permissões e manutenção de painéis - URL: https://agilize.app/docs/configuracao/relatorios-governanca/permissoes-manutencao-paineis - Resumo: Como controlar acesso, edição, duplicação, exclusão e revisão dos painéis e itens de relatório do BI da Agilize. - Seções: Permissão de acesso | Edição e manutenção | Projeto e global | Rotina de manutenção | Problemas comuns | Checklist de controle | Próximo passo - Conteúdo útil: Permissões e manutenção de painéis Painéis de BI influenciam decisões de gestão. Por isso, a manutenção deve ter dono, permissão correta e rotina de revisão. O objetivo é permitir análise ampla sem transformar todos os usuários em administradores. Use este guia para definir quem pode consultar, criar, editar, duplicar e excluir painéis em https://my.agilize.app/report/. Acesso pela tela: barra superior Relatórios > Relatórios e Insights. Pela sidebar lateral, troque para Hub/CRM e abra Relatórios. Permissão de acesso O acesso à área de Relatórios e Insights depende da permissão da funcionalidade de relatórios. Usuários sem essa permissão não devem ser orientados a abrir a tela de BI. Depois... ### RH/Workforce - URL: https://agilize.app/docs/configuracao/rh-workforce - Resumo: Guias administrativos para configurar jornada, perfis, feriados, associações e ocorrências. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: RH/Workforce Use esta seção para configurar a base administrativa do módulo de jornada. Guias desta seção - Configuração do módulo de RH/Workforce. - Cadastrar perfis de jornada. Próximo passo Para orientar a rotina de uso, acesse RH e jornada. ### Cadastrar perfis de jornada - URL: https://agilize.app/docs/configuracao/rh-workforce/cadastrar-perfis-de-jornada - Resumo: Como criar perfis de jornada no RH/Workforce, definindo horários, almoço, pausas obrigatórias, bloqueio fora do horário, tolerância e liberação excepcional. - Seções: Como acessar | Antes de criar | Fluxo recomendado | Identificação do perfil | Semana de trabalho | Almoço obrigatório | Pausas obrigatórias | Bloqueio fora do horário - Conteúdo útil: Cadastrar perfis de jornada O perfil de jornada define a regra de horário que será aplicada aos colaboradores no Workforce. Ele controla dias de trabalho, início e fim da jornada, almoço obrigatório, pausas obrigatórias, bloqueio fora do horário, tolerância de ponto e possibilidade de liberação excepcional antes ou depois do expediente. Use perfis de jornada para representar escalas reais da operação, como Comercial - Segunda a sexta, Suporte - Turno tarde ou Plantão - Sábado. Evite criar um perfil para cada pessoa quando várias pessoas seguem a mesma regra. Como acessar Acesse https://my.agilize.app/crm/workforce/scheduleProfile. Pela sidebar lateral da plataforma, troque o módulo para Wor... ### Configuração do módulo de RH/Workforce - URL: https://agilize.app/docs/configuracao/rh-workforce/configuracao-rh-workforce - Resumo: Como estruturar jornadas, perfis, feriados, associações, motivos de status e ocorrências no módulo de RH/Workforce. - Seções: Estrutura do módulo | Ordem recomendada de configuração | Perfis de jornada | Calendário de feriados | Jornada por usuário | Motivos de status | Ocorrências de jornada | Aprovações e ajustes - Conteúdo útil: Configuração do módulo de RH/Workforce O módulo de RH/Workforce organiza a jornada da equipe, acompanhando perfis de horário, feriados, associações por usuário, motivos de status, ocorrências, aprovações e relatórios. Configure essa área antes de cobrar indicadores de jornada. A qualidade dos relatórios depende da clareza dos perfis, da vigência por usuário e da forma como exceções são registradas. Estrutura do módulo As principais áreas são: | Área | Caminho público | Uso | | --- | --- | --- | | Relatório de Jornada | https://my.agilize.app/crm/workforce/time-report | Acompanhar registros e indicadores de jornada. | | Espelho de Jornada | https://my.agilize.app/crm/workforce/time-mirror |... ### Roteamento e distribuição - URL: https://agilize.app/docs/configuracao/roteamento-distribuicao - Resumo: Guias para levar conversas, oportunidades e demandas ao time correto. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Roteamento e distribuição Use esta seção para definir como demandas chegam ao responsável correto. Essas regras sustentam atendimento, CRM, suporte, bot e automações. Guias desta seção - Regras de roteamento e distribuição. Próximo passo Para desenhar fluxos e ações automáticas, acesse Fluxos e automações. ### Regras de roteamento e distribuição - URL: https://agilize.app/docs/configuracao/roteamento-distribuicao/regras-de-roteamento-e-distribuicao - Resumo: Como configurar canais, departamentos, equipes, suporte, fluxos do bot e automações para direcionar demandas ao time certo. - Seções: Quando configurar | Caminhos principais | Conceitos principais | Entrada por canal | WhatsApp | LiveChat | Voz e PBX | Departamentos de atendimento - Conteúdo útil: Regras de roteamento e distribuição Roteamento define para onde uma demanda deve ir. Distribuição define quem deve assumir ou receber a próxima ação. Na Agilize, essas duas decisões aparecem em conversas, departamentos, suporte, oportunidades, tarefas, fluxos do bot e automações de CRM. Use este guia para configurar entradas por canal, departamentos, equipes, regras de suporte e automações sem deixar conversas ou registros sem responsável. ::DocsDiagram --- title: "Caminho da demanda até o responsável" caption: "Uma demanda entra por um canal, passa por regras de destino e chega ao Flow do usuário ou fica disponível para acompanhamento do time." definition: | flowchart LR A[Canal de entrada... ### Telefonia - URL: https://agilize.app/docs/configuracao/telefonia - Resumo: Guias de filas, ramais, URA e vínculo de fluxo de telefonia no número de entrada. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Telefonia Use esta seção para preparar a operação de voz antes de atender chamadas reais. Guias desta seção - Cadastro de filas de telefonia. - Cadastro de ramais. - Cadastro de URA. - Vínculo do Fluxo de Telefonia no Número de Entrada. Próximo passo Para acompanhar chamadas em operação, acesse Monitoramento de Telefonia. ### Cadastro de filas de telefonia - URL: https://agilize.app/docs/configuracao/telefonia/cadastro-de-filas-telefonia - Resumo: Como configurar filas de atendimento telefônico, estratégia de toque, ramais, música em espera, limites e destinos de exceção. - Seções: Onde configurar | Campos principais | Estratégias de toque | Entrada e permanência sem atendente | Anúncios e música em espera | Tempos e limites | Pausa automática e ramal ocupado | Destino em caso de remoção - Conteúdo útil: Cadastro de filas de telefonia Filas de telefonia organizam chamadas recebidas e distribuem o atendimento entre ramais. Uma boa fila define quem atende, por quanto tempo a pessoa aguarda, qual estratégia de toque será usada e para onde a chamada vai quando não puder continuar esperando. Use este guia para criar filas previsíveis, com capacidade clara e tratamento de exceções. ::DocsDiagram --- title: "Como uma fila recebe chamadas" caption: "A fila conecta a chamada aos ramais disponíveis e precisa ter um destino para os casos de remoção ou timeout." definition: | flowchart LR A[Chamada recebida] --> B[Destino aponta para fila] B --> C{Há ramais disponíveis?} C -->|Sim| D[Aplicar estratégia... ### Cadastro de ramais - URL: https://agilize.app/docs/configuracao/telefonia/cadastro-de-ramais - Resumo: Como cadastrar ramais, vincular usuários, controlar senha SIP, gravação de chamadas e grupo de saída. - Seções: Onde configurar | Campos do ramal | Número e identificação | Senha SIP | Usuário vinculado | Gravação de entrada e saída | Grupo de saída | Relação com filas - Conteúdo útil: Cadastro de ramais Ramais conectam usuários à operação de telefonia. Eles permitem atender chamadas, aparecer no monitoramento, participar de filas, usar softphone quando disponível e receber ações de transferência. Use este guia para criar ramais identificáveis, seguros e vinculados aos usuários corretos. Onde configurar Acesse https://my.agilize.app/voice/pbx/extension. Acesso pela tela: sidebar lateral > módulo Voz > Configurações. Na tree de Configurações, abra Ramais. Campos do ramal | Campo | Como preencher | Impacto | | --- | --- | --- | | Número Ramal | Número interno do ramal. | Identifica o agente em filas, transferências, monitoramento e discagem interna. | | Nome / Bina | Nome e... ### Cadastro de URA - URL: https://agilize.app/docs/configuracao/telefonia/cadastro-de-ura - Resumo: Como configurar menus de voz com áudio inicial, opções de teclado, tempo de espera e destinos de atendimento. - Seções: Onde configurar | Campos da URA | Áudio inicial | Opções e destinos | Tempo limite | Acesso a ramal direto | Quando usar URA ou fluxo avançado | Teste recomendado - Conteúdo útil: Cadastro de URA URA é o menu telefônico que toca uma mensagem e encaminha a chamada conforme a opção digitada. Ela é útil para separar comercial, suporte, financeiro, segunda via, horário de atendimento ou qualquer caminho simples por teclado. Use URA quando a primeira decisão da chamada pode ser resolvida com poucas opções claras. Para jornadas mais longas, regras condicionais ou integrações, prefira um fluxo avançado de telefonia. ::DocsDiagram --- title: "Funcionamento de uma URA" caption: "A URA toca um áudio, aguarda uma tecla e envia a chamada ao destino configurado." definition: | flowchart LR A[Chamada entra na URA] --> B[Tocar áudio inicial] B --> C{Cliente digitou opção?} C -->|Op... ### Vínculo do Fluxo de Telefonia no Número de Entrada - URL: https://agilize.app/docs/configuracao/telefonia/vinculo-fluxo-telefonia-numero-entrada - Resumo: Como definir o destino de um número de entrada para executar fluxo avançado, fila, ramal, URA ou outro caminho de telefonia. - Seções: Onde configurar | Campos do número de entrada | Tipos de destino disponíveis | Quando escolher fluxo avançado | Sequência recomendada | Cuidados antes de salvar | Teste recomendado | Problemas comuns - Conteúdo útil: Vínculo do Fluxo de Telefonia no Número de Entrada O número de entrada é a porta por onde a chamada chega à operação. O destino configurado nele define qual regra será executada primeiro: um fluxo avançado, uma fila, uma URA, um ramal ou outro destino de telefonia. Esse vínculo é crítico. Um número com destino errado pode mandar clientes para a fila incorreta, pular uma URA, ignorar regras de horário ou executar um fluxo antigo. ::DocsDiagram --- title: "Entrada da chamada" caption: "O número recebe a ligação e envia para o primeiro destino configurado." definition: | flowchart LR A[Cliente liga para o número] --> B[Número de entrada] B --> C{Destino configurado} C -->|Fluxo avançado| D[Exe... ### Guias de integração - URL: https://agilize.app/docs/desenvolvedores/guias-integracao - Resumo: Guias práticos para entender autenticação, primeiros passos e tratamento de webhooks. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Guias de integração Use estes guias para aprender o caminho prático de integração antes de consultar a referência completa. Guias desta seção - Introdução à API. - Autenticação. - Webhooks. Próximo passo Para consultar endpoints e eventos completos, acesse Referência técnica. ### Webhooks - URL: https://agilize.app/docs/desenvolvedores/guias-integracao/webhooks - Resumo: Como preparar um endpoint para receber eventos enviados pela Agilize. - Seções: Antes de configurar | Eventos disponíveis | Boas práticas - Conteúdo útil: Webhooks Webhooks permitem que um sistema externo receba eventos da Agilize sem precisar consultar a API continuamente. Antes de configurar - Crie uma URL pública HTTPS para receber eventos. - Garanta que o endpoint responda rapidamente. - Registre logs suficientes para investigar falhas. - Valide o formato do payload antes de processar regras de negócio. Eventos disponíveis A lista abaixo é carregada automaticamente a partir do Swagger oficial da Agilize. Quando a API oficial não estiver disponível, a documentação usa a última versão local de fallback. ::OpenApiWebhooks{specUrl="/api/docs/openapi/agilize"} :: Boas práticas - Responda com status de sucesso apenas depois de receber o evento... ### Referência técnica - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica - Resumo: Referência interativa da API, endpoints gerados pelo OpenAPI e webhooks técnicos. - Seções: Referências disponíveis | Próximo passo - Conteúdo útil: Referência técnica Esta seção é para consulta técnica. Ela separa a referência de endpoints e webhooks dos guias práticos de integração. Referências disponíveis - Referência interativa da API. - Endpoints da API. - Webhooks técnicos. Próximo passo Se ainda estiver iniciando a integração, volte para Guias de integração. ### Endpoints da API - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api - Resumo: Referência dos métodos da API Agilize organizada por assunto e serviço. - Seções: Assuntos | Testes interativos - Conteúdo útil: Esta seção organiza os métodos da API por assunto. Cada página mostra URL, autenticação, parâmetros, corpo de requisição, respostas e exemplos básicos para integração. Assuntos - File - Upload - 7 métodos - Messenger - Chat - 11 métodos - Voice - PBX - 2 métodos - CRM - Timeline - 5 métodos - CRM - Lead - 25 métodos - CRM - Support - 10 métodos - CRM - Contact - 5 métodos - CRM - Company - 5 métodos - CRM - Tag - 5 métodos - Messenger - SMS - 5 métodos - Messenger - Meta - 5 métodos - Messenger - WhatsApp - 5 métodos - User - User - 5 métodos Testes interativos Para testar chamadas com Try it e gerar código em mais linguagens, use também a referência interativa da API. ### CRM - Lead - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead - Resumo: Eventos de webhook da Agilize para CRM - Lead. - Seções: Página principal - Conteúdo útil: Eventos disponíveis para este assunto. Cada serviço agrupa webhooks do mesmo recurso para manter a navegação objetiva. | Serviço | Eventos | Principais eventos | | --- | --- | --- | | Oportunidade | 3 | Oportunidade - Criação, Oportunidade - Atualização, Oportunidade - Exclusão | | Funil | 3 | Funil - Criação, Funil - Atualização, Funil - Exclusão | | Origem de oportunidade | 3 | Origem de oportunidade - Criação, Origem de oportunidade - Atualização, Origem de oportunidade - Exclusão | Página principal Volte para a visão geral de webhooks para consultar a lista completa de eventos. ### Funil - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/funil - Resumo: Webhooks da Agilize para Funil em CRM - Lead. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Funil - Criação | crm/lead/funnel/create | Funil - Criação | | POST | Funil - Atualização | crm/lead/funnel/patch | Funil - Atualização | | POST | Funil - Exclusão | crm/lead/funnel/remove | Funil - Exclusão | ### Funil - Criação - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/funil/post-crm-lead-funnel-create - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/funnel/create Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | name | string | Não | | | | stages | object[] | Não | | | | deleted | boolean | Não | | | | validatePreviousStageRequirements | boolean | Não | | | | allowArchiveWithoutRequiredFields | boolean | Não | | | | disableDefaultWonLossStages | boolean | Não | | | | hideWonKanban | boolean | Não | | | | hideArchivedKanban | boolean | Não | | | Exemplo básico recebido: json { "name": "va... ### Funil - Atualização - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/funil/post-crm-lead-funnel-patch - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/funnel/patch Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | name | string | Não | | | | stages | object[] | Não | | | | deleted | boolean | Não | | | | validatePreviousStageRequirements | boolean | Não | | | | allowArchiveWithoutRequiredFields | boolean | Não | | | | disableDefaultWonLossStages | boolean | Não | | | | hideWonKanban | boolean | Não | | | | hideArchivedKanban | boolean | Não | | | Exemplo básico recebido: json { "name": "val... ### Funil - Exclusão - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/funil/post-crm-lead-funnel-remove - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/funnel/remove Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | id | string | Não | | Identificador do registro excluído | Exemplo básico recebido: json { "id": "valor" } Respostas | Status | Descrição | Conteúdo | | --- | --- | --- | | 200 | Return a 200 status to indicate that the data was received successfully | | Boas práticas - Trate reenvios como possibilidade real. - Valide o payload antes de executar regras de negócio. - Registre o id... ### Oportunidade - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/oportunidade - Resumo: Webhooks da Agilize para Oportunidade em CRM - Lead. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Oportunidade - Criação | crm/lead/lead/create | Oportunidade - Criação | | POST | Oportunidade - Atualização | crm/lead/lead/patch | Oportunidade - Atualização | | POST | Oportunidade - Exclusão | crm/lead/lead/remove | Oportunidade - Exclusão | ### Oportunidade - Criação - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/oportunidade/post-crm-lead-lead-create - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/lead/create Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | contacts | string[] | Não | | | | automations | string[] | Não | | | | companies | string[] | Não | | | | phones | object[] | Não | | | | emails | object[] | Não | | | | socials | object[] | Não | | | | name | string | Não | | Nome descritivo | | user | string | Não | | | | createdBy | string | Não | | | | import | string | Não | | Id da importação, caso tenha sido importado | | no... ### Oportunidade - Atualização - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/oportunidade/post-crm-lead-lead-patch - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/lead/patch Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | contacts | string[] | Não | | | | automations | string[] | Não | | | | companies | string[] | Não | | | | phones | object[] | Não | | | | emails | object[] | Não | | | | socials | object[] | Não | | | | name | string | Não | | Nome descritivo | | user | string | Não | | | | createdBy | string | Não | | | | import | string | Não | | Id da importação, caso tenha sido importado | | not... ### Oportunidade - Exclusão - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/oportunidade/post-crm-lead-lead-remove - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/lead/remove Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | id | string | Não | | Identificador do registro excluído | Exemplo básico recebido: json { "id": "valor" } Respostas | Status | Descrição | Conteúdo | | --- | --- | --- | | 200 | Return a 200 status to indicate that the data was received successfully | | Boas práticas - Trate reenvios como possibilidade real. - Valide o payload antes de executar regras de negócio. - Registre o iden... ### Origem de oportunidade - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/origem-de-oportunidade - Resumo: Webhooks da Agilize para Origem de oportunidade em CRM - Lead. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Origem de oportunidade - Criação | crm/lead/source/create | Origem de oportunidade - Criação | | POST | Origem de oportunidade - Atualização | crm/lead/source/patch | Origem de oportunidade - Atualização | | POST | Origem de oportunidade - Exclusão | crm/lead/source/remove | Origem de oportunidade - Exclusão | ### Origem de oportunidade - Criação - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/origem-de-oportunidade/post-crm-lead-source-create - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/source/create Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | name | string | Não | | | | color | string | Não | | | Exemplo básico recebido: json { "name": "valor", "color": "valor" } Respostas | Status | Descrição | Conteúdo | | --- | --- | --- | | 200 | Return a 200 status to indicate that the data was received successfully | | Boas práticas - Trate reenvios como possibilidade real. - Valide o payload antes de executar regras de negócio.... ### Origem de oportunidade - Atualização - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/origem-de-oportunidade/post-crm-lead-source-patch - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/source/patch Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | name | string | Não | | | | color | string | Não | | | Exemplo básico recebido: json { "name": "valor", "color": "valor" } Respostas | Status | Descrição | Conteúdo | | --- | --- | --- | | 200 | Return a 200 status to indicate that the data was received successfully | | Boas práticas - Trate reenvios como possibilidade real. - Valide o payload antes de executar regras de negócio.... ### Origem de oportunidade - Exclusão - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-lead/origem-de-oportunidade/post-crm-lead-source-remove - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/lead/source/remove Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | id | string | Não | | Identificador do registro excluído | Exemplo básico recebido: json { "id": "valor" } Respostas | Status | Descrição | Conteúdo | | --- | --- | --- | | 200 | Return a 200 status to indicate that the data was received successfully | | Boas práticas - Trate reenvios como possibilidade real. - Valide o payload antes de executar regras de negócio. - Registre o id... ### CRM - Support - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support - Resumo: Eventos de webhook da Agilize para CRM - Support. - Seções: Página principal - Conteúdo útil: Eventos disponíveis para este assunto. Cada serviço agrupa webhooks do mesmo recurso para manter a navegação objetiva. | Serviço | Eventos | Principais eventos | | --- | --- | --- | | Suporte | 3 | Suporte - Criação, Suporte - Atualização, Suporte - Exclusão | Página principal Volte para a visão geral de webhooks para consultar a lista completa de eventos. ### Suporte - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support/suporte - Resumo: Webhooks da Agilize para Suporte em CRM - Support. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Suporte - Criação | crm/support/support/create | Suporte - Criação | | POST | Suporte - Atualização | crm/support/support/patch | Suporte - Atualização | | POST | Suporte - Exclusão | crm/support/support/remove | Suporte - Exclusão | ### Suporte - Criação - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support/suporte/post-crm-support-support-create - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/support/support/create Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | customer | string | Não | Exemplo: 664f5ab2c3d4e5f678901234 | Cliente do CRM associado ao ticket quando a operacao usar vinculo formal de customer. | | room | string | Não | Exemplo: 664f5ab2c3d4e5f678901235 | Sala de conversa de origem do ticket. Usada para vinculo operacional com o Messenger. | | contact | string | Não | Exemplo: 664f5ab2c3d4e5f678901236 | Contato principal... ### Suporte - Atualização - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support/suporte/post-crm-support-support-patch - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/support/support/patch Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | customer | string | Não | Exemplo: 664f5ab2c3d4e5f678901234 | Cliente do CRM associado ao ticket quando a operacao usar vinculo formal de customer. | | room | string | Não | Exemplo: 664f5ab2c3d4e5f678901235 | Sala de conversa de origem do ticket. Usada para vinculo operacional com o Messenger. | | contact | string | Não | Exemplo: 664f5ab2c3d4e5f678901236 | Contato principal... ### Suporte - Exclusão - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/crm-support/suporte/post-crm-support-support-remove - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST crm/support/support/remove Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | id | string | Não | | Identificador do registro excluído | Exemplo básico recebido: json { "id": "valor" } Respostas | Status | Descrição | Conteúdo | | --- | --- | --- | | 200 | Return a 200 status to indicate that the data was received successfully | | Boas práticas - Trate reenvios como possibilidade real. - Valide o payload antes de executar regras de negócio. - Registre... ### File - Upload - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload - Resumo: Eventos de webhook da Agilize para File - Upload. - Seções: Página principal - Conteúdo útil: Eventos disponíveis para este assunto. Cada serviço agrupa webhooks do mesmo recurso para manter a navegação objetiva. | Serviço | Eventos | Principais eventos | | --- | --- | --- | | Documento | 3 | Documento - Criação, Documento - Atualização, Documento - Exclusão | Página principal Volte para a visão geral de webhooks para consultar a lista completa de eventos. ### Documento - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload/documento - Resumo: Webhooks da Agilize para Documento em File - Upload. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Documento - Criação | file/upload/create | Documento - Criação | | POST | Documento - Atualização | file/upload/patch | Documento - Atualização | | POST | Documento - Exclusão | file/upload/remove | Documento - Exclusão | ### Documento - Criação - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload/documento/post-file-upload-create - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST file/upload/create Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | mimetype | string | Não | | | | name | string | Não | | | | size | number | Não | | | | category | string | Não | | | | md5 | string | Não | | | | isTemp | boolean | Não | | | | canDelete | boolean | Não | | | | canDeleteLocal | boolean | Não | | | | extStorage | boolean | Não | | | | contact | string | Não | | | | lead | string | Não | | | | storage | string | Não | | | Exemplo bási... ### Documento - Atualização - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload/documento/post-file-upload-patch - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST file/upload/patch Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | mimetype | string | Não | | | | name | string | Não | | | | size | number | Não | | | | category | string | Não | | | | md5 | string | Não | | | | isTemp | boolean | Não | | | | canDelete | boolean | Não | | | | canDeleteLocal | boolean | Não | | | | extStorage | boolean | Não | | | | contact | string | Não | | | | lead | string | Não | | | | storage | string | Não | | | Exemplo básic... ### Documento - Exclusão - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/file-upload/documento/post-file-upload-remove - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST file/upload/remove Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | id | string | Não | | Identificador do registro excluído | Exemplo básico recebido: json { "id": "valor" } Respostas | Status | Descrição | Conteúdo | | --- | --- | --- | | 200 | Return a 200 status to indicate that the data was received successfully | | Boas práticas - Trate reenvios como possibilidade real. - Valide o payload antes de executar regras de negócio. - Registre o identi... ### Messenger - Chat - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat - Resumo: Eventos de webhook da Agilize para Messenger - Chat. - Seções: Página principal - Conteúdo útil: Eventos disponíveis para este assunto. Cada serviço agrupa webhooks do mesmo recurso para manter a navegação objetiva. | Serviço | Eventos | Principais eventos | | --- | --- | --- | | Sala de Conversa | 3 | Sala de Conversa - Criação, Sala de Conversa - Atualização, Sala de Conversa - Exclusão | Página principal Volte para a visão geral de webhooks para consultar a lista completa de eventos. ### Sala de Conversa - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat/sala-de-conversa - Resumo: Webhooks da Agilize para Sala de Conversa em Messenger - Chat. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Sala de Conversa - Criação | messenger/chat/room/create | Sala de Conversa - Criação | | POST | Sala de Conversa - Atualização | messenger/chat/room/patch | Sala de Conversa - Atualização | | POST | Sala de Conversa - Exclusão | messenger/chat/room/remove | Sala de Conversa - Exclusão | ### Sala de Conversa - Criação - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat/sala-de-conversa/post-messenger-chat-room-create - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST messenger/chat/room/create Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | guest | string | Não | | | | users | string[] | Não | | | | prefUser | string | Não | | | | owner | string | Não | | | | prefUserPendAttr | boolean | Não | | | | histUsers | string[] | Não | | | | tags | string[] | Não | | | | conversationDetailTags | string[] | Não | | | | department | string | Não | | Departamento atual da sala | | contact | string | Não | | | | tl | string... ### Sala de Conversa - Atualização - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat/sala-de-conversa/post-messenger-chat-room-patch - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST messenger/chat/room/patch Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | guest | string | Não | | | | users | string[] | Não | | | | prefUser | string | Não | | | | owner | string | Não | | | | prefUserPendAttr | boolean | Não | | | | histUsers | string[] | Não | | | | tags | string[] | Não | | | | conversationDetailTags | string[] | Não | | | | department | string | Não | | Departamento atual da sala | | contact | string | Não | | | | tl | string... ### Sala de Conversa - Exclusão - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chat/sala-de-conversa/post-messenger-chat-room-remove - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST messenger/chat/room/remove Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | id | string | Não | | Identificador do registro excluído | Exemplo básico recebido: json { "id": "valor" } Respostas | Status | Descrição | Conteúdo | | --- | --- | --- | | 200 | Return a 200 status to indicate that the data was received successfully | | Boas práticas - Trate reenvios como possibilidade real. - Valide o payload antes de executar regras de negócio. - Registre... ### Messenger - Chatbot - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot - Resumo: Eventos de webhook da Agilize para Messenger - Chatbot. - Seções: Página principal - Conteúdo útil: Eventos disponíveis para este assunto. Cada serviço agrupa webhooks do mesmo recurso para manter a navegação objetiva. | Serviço | Eventos | Principais eventos | | --- | --- | --- | | Chatbot | 2 | Controle Fluxo de Chatbot, Webhook HTTP (Saída) do Chatbot | Página principal Volte para a visão geral de webhooks para consultar a lista completa de eventos. ### Chatbot - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot/chatbot - Resumo: Webhooks da Agilize para Chatbot em Messenger - Chatbot. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Controle Fluxo de Chatbot | messenger/chatbot/NodeHttpDelegate | Metodo HTTP que aceita um POST para processamento de mensagens. Retorno de um JSON contendo mensagens, controle do fluxo, e variáveis. Tempo limite para geração do conteúdo de até 5 minutos. | | POST | Webhook HTTP (Saída) do Chatbot | messenger/chatbot/NodeHttpWebhook | Estrutura enviada pelo node NodeHttpWebhook para a URL configurada no fluxo. Este endpoint deve ser implementado pelo cliente/terceiro para receber os dados e reagir conforme necessário. | ### Controle Fluxo de Chatbot - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot/chatbot/post-messenger-chatbot-nodehttpdelegate - Resumo: Metodo HTTP que aceita um POST para processamento de mensagens. Retorno de um JSON contendo mensagens, controle do fluxo, e variáveis. Tempo limite para geração do conteúdo de até 5 minutos. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST messenger/chatbot/NodeHttpDelegate Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | seq | integer | Sim | | Sequência da mensagem no fluxo atual | | vars | object | Sim | | | | interactiveReply | string | Não | | Resposta interativa do usuário | Estruturas internas vars json { "room": "object", "SAMPLEVAR": "string" } Exemplo básico recebido: json { "seq": 1, "vars": { "room": {}, "SAMPLEVAR": "valor" } } Respostas | Status | Descrição | Conteúdo | |... ### Webhook HTTP (Saída) do Chatbot - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot/chatbot/post-messenger-chatbot-nodehttpwebhook - Resumo: Estrutura enviada pelo node NodeHttpWebhook para a URL configurada no fluxo. Este endpoint deve ser implementado pelo cliente/terceiro para receber os dados e reagir conforme necessário. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST messenger/chatbot/NodeHttpWebhook Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | roomId | string | Sim | | ID da sala (room) no banco | | chId | string | Sim | | Identificador do canal. No WhatsApp (chSrc=1) é o número do cliente. | | chSrc | integer | Sim | | Canal de origem (1=WhatsApp, 2=Facebook, 3=Instagram, 4=SMS) | | message | string,null | Não | | Texto da mensagem atual (quando houver) | | interactiveReply | string,null | Não | | Resposta... ### Voice - PBX - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx - Resumo: Eventos de webhook da Agilize para Voice - PBX. - Seções: Página principal - Conteúdo útil: Eventos disponíveis para este assunto. Cada serviço agrupa webhooks do mesmo recurso para manter a navegação objetiva. | Serviço | Eventos | Principais eventos | | --- | --- | --- | | Channel | 2 | Channel - Discagem, Channel - Encerramento | | Call | 2 | Call - Vinculação, Call - Desvinculação | Página principal Volte para a visão geral de webhooks para consultar a lista completa de eventos. ### Call - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/call - Resumo: Webhooks da Agilize para Call em Voice - PBX. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Call - Vinculação | voice/pbx/call/link | | | POST | Call - Desvinculação | voice/pbx/call/unlink | | ### Call - Vinculação - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/call/post-voice-pbx-call-link - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST voice/pbx/call/link Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | channel | string | Sim | Exemplo: SIP/101pabx9999999.ligou.me-00001234 | Identificador do canal da ligação | | uniqueid | string | Sim | Exemplo: srv999-91234567.99 | Id da Chamada (Origem) | | subevent | string | Não | Exemplo: Begin | Definição do sub-evento. | | dialstatus | string | Não | Aceita: CHANUNAVAIL, CONGESTION, NOANSWER, BUSY, ANSWER, CANCEL · Exemplo: CANCEL | Status... ### Call - Desvinculação - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/call/post-voice-pbx-call-unlink - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST voice/pbx/call/unlink Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | channel | string | Sim | Exemplo: SIP/101pabx9999999.ligou.me-00001234 | Identificador do canal da ligação | | uniqueid | string | Sim | Exemplo: srv999-91234567.99 | Id da Chamada (Origem) | | subevent | string | Não | Exemplo: Begin | Definição do sub-evento. | | dialstatus | string | Não | Aceita: CHANUNAVAIL, CONGESTION, NOANSWER, BUSY, ANSWER, CANCEL · Exemplo: CANCEL | Statu... ### Channel - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/channel - Resumo: Webhooks da Agilize para Channel em Voice - PBX. - Conteúdo útil: Eventos disponíveis para este serviço. | Método | Evento | Identificador | Descrição | | --- | --- | --- | --- | | POST | Channel - Discagem | voice/pbx/channel/dial | | | POST | Channel - Encerramento | voice/pbx/channel/hangup | | ### Channel - Discagem - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/channel/post-voice-pbx-channel-dial - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST voice/pbx/channel/dial Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | channel | string | Sim | Exemplo: SIP/101pabx9999999.ligou.me-00001234 | Identificador do canal da ligação | | uniqueid | string | Sim | Exemplo: srv999-91234567.99 | Id da Chamada (Origem) | | subevent | string | Não | Exemplo: Begin | Definição do sub-evento. | | dialstatus | string | Não | Aceita: CHANUNAVAIL, CONGESTION, NOANSWER, BUSY, ANSWER, CANCEL · Exemplo: CANCEL | Stat... ### Channel - Encerramento - URL: https://agilize.app/docs/desenvolvedores/referencia-tecnica/webhooks/voice-pbx/channel/post-voice-pbx-channel-hangup - Resumo: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. - Seções: Evento | Como receber | Payload | Respostas | Boas práticas - Conteúdo útil: Evento http POST voice/pbx/channel/hangup Como receber Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload. Payload - Content-Type: application/json | Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição | | --- | --- | --- | --- | --- | | channel | string | Sim | Exemplo: SIP/101pabx9999999.ligou.me-00001234 | Identificador do canal da ligação | | uniqueid | string | Sim | Exemplo: srv999-91234567.99 | Id da Chamada (Origem) | | calleridnum | string | Não | Exemplo: 101 | Número da Bina (Canal Origem) | | calleridname | string | Não | Exemplo: Ramal João | Nome da Bina (Canal Origem) | | connectedlinenum | strin... ### Como a operação se organiza na Agilize - URL: https://agilize.app/docs/primeiros-passos/como-a-operacao-se-organiza - Resumo: Entenda o fluxo ponta a ponta da operação: entrada do contato, distribuição, atendimento, CRM, próximas ações, automações e acompanhamento. - Seções: Quando usar este guia | 1. Entrada do contato | 2. Distribuição para o time correto | 3. Flow como centro da rotina | 4. Conversa e atendimento | 5. CRM, oportunidades e relacionamento | 6. Tarefas e próximas ações | 7. Automações e fluxos - Conteúdo útil: Como a operação se organiza na Agilize A operação na Agilize conecta canais de entrada, Flow, atendimento, CRM, tarefas, automações e indicadores. A ideia é que cada contato recebido tenha contexto, responsável, próximo passo e acompanhamento, sem depender de controles paralelos. Use este guia para entender a jornada operacional antes de configurar filas, funis, automações ou treinar o time. ::DocsDiagram --- title: "Fluxo operacional ponta a ponta" caption: "A jornada começa no canal, passa pela distribuição e pelo Flow, continua no atendimento e pode gerar CRM, tarefas, automações e acompanhamento gerencial." definition: | flowchart LR A[Contato entra por um canal] --> B[Regras de distrib... ### Glossário da plataforma - URL: https://agilize.app/docs/primeiros-passos/glossario-da-plataforma - Resumo: Entenda os principais termos usados na Agilize em atendimento, CRM, canais, automações, permissões e configuração. - Seções: Como usar este glossário | Termos centrais | CRM e relacionamento | Atendimento, canais e mensagens | Configuração, automações e fluxos | Usuários, equipes e segurança | Termos que costumam gerar confusão | Lead e oportunidade - Conteúdo útil: Glossário da plataforma Este glossário reúne os termos mais importantes para operar, configurar e acompanhar a Agilize. Use como referência rápida quando um guia mencionar atendimento, CRM, Flow, funis, automações, canais ou permissões. Como usar este glossário Leia primeiro os termos centrais. Eles aparecem em quase todos os guias de operação e configuração: - Flow - conversa - canal - contato - empresa - lead ou oportunidade - funil - etapa - origem - responsável - tarefa - automação Termos centrais | Termo | O que significa | Na prática | | --- | --- | --- | | Flow | Área operacional persistente que acompanha as telas da Agilize e reúne itens que precisam de ação. | O operador usa o Flow... ### Papéis e responsabilidades - URL: https://agilize.app/docs/primeiros-passos/papeis-e-responsabilidades - Resumo: Entenda a diferença entre operador, gestor, administrador e integrador na Agilize, e saiba o que cada perfil deve operar, configurar ou acompanhar. - Seções: Visão rápida | Operador | Gestor | Administrador | Integrador | Matriz de responsabilidades | Como definir acesso | Quando envolver cada papel - Conteúdo útil: Papéis e responsabilidades A Agilize funciona melhor quando cada pessoa sabe o que deve operar, acompanhar, configurar ou integrar. Esta página ajuda a separar responsabilidades entre operador, gestor, administrador e integrador, evitando excesso de acesso, retrabalho e dúvidas sobre quem deve agir. Use este guia para planejar implantação, treinar novos usuários, revisar permissões ou organizar uma operação que já está em andamento. Visão rápida | Papel | Foco | Responsabilidade principal | | --- | --- | --- | | Operador | Execução da rotina diária. | Atender conversas, acompanhar o Flow, atualizar registros e concluir ações. | | Gestor | Acompanhamento e qualidade. | Ver filas, gargalos, o... ### Guia de primeiros 30 minutos - URL: https://agilize.app/docs/primeiros-passos/primeiros-30-minutos - Resumo: Roteiro rápido para reconhecer as áreas principais da Agilize, entender a rotina pelo Flow e validar configurações básicas antes de operar. - Seções: Antes de começar | 0 a 5 minutos: entenda a estrutura | 5 a 10 minutos: reconheça o Flow | 10 a 15 minutos: localize canais e conversas | 15 a 20 minutos: entenda o CRM | 20 a 25 minutos: valide configurações básicas | 25 a 30 minutos: feche com uma checagem prática | Roteiro por perfil - Conteúdo útil: Guia de primeiros 30 minutos Este guia ajuda um novo usuário a se localizar na Agilize em uma primeira sessão curta. O objetivo não é configurar toda a conta, mas reconhecer as áreas principais, entender onde a rotina começa e validar se a base mínima está pronta para operar. Use este roteiro depois de receber acesso à plataforma em https://my.agilize.app. Antes de começar Confirme com o administrador da conta: - qual é seu papel na operação: operador, gestor, administrador ou integrador; - quais canais estarão em uso, como WhatsApp, Livechat, SMS ou telefone; - se você deve atender conversas, acompanhar oportunidades, configurar regras ou apenas visualizar indicadores; - se seu acesso já i... ### CRM e relacionamento - URL: https://agilize.app/docs/usuarios/crm-relacionamento - Resumo: Guias para oportunidades, contatos, empresas, tarefas, suporte e classificação operacional. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: CRM e relacionamento Use esta seção para transformar interações em relacionamento rastreável. Os guias cobrem oportunidades, contatos, empresas, tarefas, suporte e classificação operacional. Guias desta seção - CRM e oportunidades. - Contatos e empresas. - Tarefas e próximas ações. - Suporte e registros de atendimento. - Tags e classificação operacional. Próximo passo Para acompanhar performance e gargalos, avance para Relatórios e BI. ### Contatos e empresas - URL: https://agilize.app/docs/usuarios/crm-relacionamento/contatos-e-empresas - Resumo: Como consultar, criar, atualizar e relacionar contatos e empresas na Agilize para manter histórico, canais de comunicação e oportunidades organizados. - Seções: Quando usar | Como contatos, empresas e oportunidades se conectam | Acessar contatos e empresas | Consultar antes de criar | Criar ou atualizar um contato | Criar ou atualizar uma empresa | Relacionar contato, empresa e oportunidade | Usar canais de contato rápido - Conteúdo útil: Contatos e empresas Contatos e empresas formam a base de relacionamento da operação. Eles conectam pessoas, organizações, canais de comunicação, oportunidades, conversas e próximas ações em um histórico mais confiável. Use este guia para consultar registros, criar cadastros, relacionar contatos com empresas, evitar duplicidades e manter a base pronta para atendimento, vendas, campanhas e acompanhamento gerencial. Quando usar Use este guia quando você precisa: - cadastrar uma pessoa ou organização; - encontrar telefones, e-mails e redes sociais; - vincular um contato a uma empresa; - vincular uma empresa a seus contatos; - consultar oportunidades relacionadas; - revisar histórico antes de fa... ### Suporte e registros de atendimento - URL: https://agilize.app/docs/usuarios/crm-relacionamento/suporte-e-registros-de-atendimento - Resumo: Como abrir, classificar, acompanhar e encerrar registros de suporte na Agilize usando categoria, prioridade, SLA, responsável, histórico e Flow. - Seções: Quando usar | Ciclo de atendimento | Acessar suportes | Abrir um suporte | Classificar com categoria e subcategoria | Definir prioridade | Trabalhar com SLA e prazo | Equipe e responsável - Conteúdo útil: Suporte e registros de atendimento Registros de suporte organizam demandas que precisam de acompanhamento formal. Eles ajudam a transformar uma solicitação, incidente, melhoria ou pendência de atendimento em um item rastreável, com responsável, prioridade, categoria, prazo e histórico. Use este guia para abrir suportes, classificar corretamente, acompanhar SLA, registrar interações e encerrar demandas sem perder contexto do cliente. Quando usar Use um registro de suporte quando a demanda precisa ser acompanhada além de uma conversa simples. Exemplos comuns: - o cliente relatou um problema que precisa de análise; - a equipe precisa registrar uma solicitação interna ou externa; - uma conversa... ### Tags e classificação operacional - URL: https://agilize.app/docs/usuarios/crm-relacionamento/tags-e-classificacao-operacional - Resumo: Como usar tags na Agilize para classificar conversas, chamadas, suportes, oportunidades, contatos, empresas e históricos sem poluir relatórios e automações. - Seções: Quando usar | Ciclo de uso | Onde as tags são usadas | Acessar e cadastrar tags | Aplicar tags na operação | Usar tags em oportunidades | Usar tags em contatos e empresas | Usar tags em conversas e históricos - Conteúdo útil: Tags e classificação operacional Tags são etiquetas rápidas para classificar registros e facilitar filtros, segmentações, automações e acompanhamento operacional. Elas ajudam o time a marcar contexto que não cabe bem em status, etapa, categoria ou responsável. Use tags com critério. Uma boa tag deixa a operação mais clara; muitas tags parecidas deixam relatórios e automações inconsistentes. Quando usar Use tags quando precisar marcar uma característica complementar do registro. Exemplos úteis: - origem ou campanha especial; - interesse do cliente; - perfil de prioridade comercial; - motivo de contato; - necessidade de retorno; - tipo de problema; - risco de churn; - base para transmissão; -... ### Tarefas e próximas ações - URL: https://agilize.app/docs/usuarios/crm-relacionamento/tarefas-e-proximas-acoes - Resumo: Como criar, acompanhar, concluir e organizar tarefas na Agilize para manter continuidade em atendimentos, oportunidades, contatos e empresas. - Seções: Quando usar | Visão geral do ciclo | Acessar tarefas | Criar uma tarefa | Escolher o tipo correto | Vincular ao contexto certo | Usar data, duração, convidados e reunião | Configurar notificação - Conteúdo útil: Tarefas e próximas ações Tarefas ajudam o time a transformar conversas, oportunidades e relacionamentos em próximos passos claros. Elas reduzem esquecimentos, deixam o responsável definido e mantêm a operação com previsibilidade. Use este guia para criar atividades, vincular contexto, acompanhar pendências, concluir ações e organizar a rotina em lista, agenda ou quadro. Quando usar Use uma tarefa quando houver uma ação futura que precisa de dono e data, como: - retornar uma ligação; - enviar proposta ou e-mail; - fazer follow-up por WhatsApp; - agendar uma reunião; - revisar uma oportunidade; - confirmar informação com contato ou empresa; - concluir uma pendência de atendimento; - acompanha... ### Flow e atendimento - URL: https://agilize.app/docs/usuarios/flow-e-atendimento - Resumo: Guias para operar conversas, canais, sessão WhatsApp, bots e atendimento humano a partir do Flow. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Flow e atendimento Esta seção reúne os guias da rotina diária de atendimento. Comece pelo Flow: ele acompanha as telas da Agilize, centraliza itens acionáveis e conecta conversas, tarefas, suporte e oportunidades. Guias desta seção - Flow na rotina operacional. - Caixa de entrada e filas de atendimento. - Atendimento omnichannel. - Chat interno e salas internas. - Fluxo de conversa e conclusão do atendimento. - WhatsApp, chat, SMS e telefone na rotina. - Sessão de 24 horas no WhatsApp. - Automações e IA no dia a dia. - Execução operacional de fluxos do bot. Próximo passo Depois de entender a rotina de atendimento, avance para CRM e relacionamento para conectar conversas a oportunidades, con... ### Caixa de entrada e filas de atendimento - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/caixa-de-entrada-e-filas-de-atendimento - Resumo: Como acompanhar filas de atendimento, priorizar conversas, entender status, responsáveis, departamentos e evitar conversas paradas. - Seções: Quando usar | Onde a fila aparece | Como ler os grupos da fila | Status da conversa | Como priorizar atendimentos | Responsável e participantes | Departamentos e distribuição | Como agir em uma conversa da fila - Conteúdo útil: Caixa de entrada e filas de atendimento A caixa de entrada na Agilize é organizada pelo Flow. É ali que o operador acompanha conversas distribuídas, mensagens pendentes, conversas atuais, visitantes e outros itens que precisam de ação. Use este guia para manter filas com dono claro, reduzir conversas paradas e entender quando assumir, transferir, concluir ou escalar um atendimento. !Flow com conversas atuais, chat interno e tarefas distribuídas ao usuário Quando usar Use este guia quando você precisa: - entender quais conversas precisam de ação; - diferenciar conversa aguardando atendimento, pendente, em atendimento e concluída; - decidir o que responder primeiro; - organizar responsáveis p... ### Chat interno e salas internas - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/chat-interno-e-salas-internas - Resumo: Como usar o chat interno do Flow para conversas diretas, grupos e canais do projeto sem misturar alinhamentos internos com atendimento ao cliente. - Seções: Onde usar | Tipos de sala interna | Grupo ou canal do projeto | Criar uma sala | Prioridade no Flow | Favoritos e salas acompanhadas | Configurações dos grupos do Flow | Painel Conversar - Conteúdo útil: Chat interno e salas internas O chat interno ajuda a equipe a resolver dúvidas, alinhar decisões e acionar pessoas certas sem sair da rotina operacional. Ele aparece no Flow como uma área de comunicação interna, separada das conversas com clientes. Use este guia para entender quando usar mensagem direta, grupo ou canal do projeto, e como manter o alinhamento interno sem perder contexto do atendimento, CRM, suporte ou vendas. !Flow lateral com conversas atuais, chat interno, tarefas e ações pendentes do usuário Onde usar O chat interno fica no Flow, no painel Conversar, identificado como Salas internas. Na rotina, use o chat interno quando você precisa: - pedir ajuda a outro usuário durante... ### Execução operacional de fluxos do bot - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/execucao-operacional-de-fluxos-do-bot - Resumo: Como interpretar intervenções do bot, retomadas de fluxo, desvios, transferências e encerramentos automáticos durante a rotina de atendimento. - Seções: O que o bot pode fazer | Como interpretar no dia a dia | Quando deixar o fluxo seguir | Quando assumir manualmente | Transferência para atendimento humano | Retomadas e timeouts | Conclusão e fluxo de encerramento | Como corrigir desvios - Conteúdo útil: Execução operacional de fluxos do bot Fluxos do bot automatizam partes da conversa antes, durante ou depois do atendimento humano. Eles podem enviar mensagens, pedir informações, validar respostas, oferecer opções, acionar IA, gerar registros no CRM, transferir para departamentos, destacar dados importantes e executar um fluxo de encerramento quando o atendimento é concluído. Para o operador, o ponto principal é saber quando deixar o fluxo seguir, quando assumir a conversa manualmente e quando pedir revisão da configuração. ::DocsDiagram --- title: "Ciclo operacional do bot" caption: "O bot conduz a entrada e a qualificação; o Flow entrega a conversa ao operador quando houver distribuição p... ### Flow na rotina operacional - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/flow-na-rotina-operacional - Resumo: Como usar o Flow como central diária de conversas, tarefas, leads, suporte, processos e ações que precisam de acompanhamento. - Seções: Quando usar | O que o Flow resolve | Onde o Flow aparece | Monitorar não substitui o Flow | Fontes de dados que podem aparecer no Flow | Como priorizar a lista | Como agir em cada item | Personalização e visibilidade - Conteúdo útil: Flow na rotina operacional O Flow é a central de trabalho da Agilize. Ele acompanha as telas operacionais da plataforma e reúne itens que precisam de ação, acompanhamento ou decisão, como conversas, tarefas, leads, chamadas, suporte, processos e comunicação interna. Use este guia para entender como o operador deve começar o dia, priorizar ações e manter continuidade entre atendimento, CRM, suporte e gestão. !Flow lateral com conversas atuais, chat interno, tarefas e ações pendentes do usuário Quando usar Use o Flow quando você precisa: - iniciar conversas distribuídas para o seu usuário; - acompanhar mensagens pendentes e conversas em andamento; - tratar tarefas e próximas ações do CRM; - i... ### Fluxo de conversa e conclusão do atendimento - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/fluxo-de-conversa-e-conclusao-do-atendimento - Resumo: Como conduzir uma conversa depois da distribuição, registrar contexto, transferir quando necessário e concluir o atendimento sem quebrar a continuidade. - Seções: Quando usar | Onde a conversa começa | Como iniciar o atendimento | Como conduzir a conversa | Entrar, sair, transferir e concluir | Quando transferir | O que revisar antes de concluir | O que acontece ao concluir - Conteúdo útil: Fluxo de conversa e conclusão do atendimento Uma conversa na Agilize não termina quando o operador envia a última mensagem. Ela passa por uma jornada operacional: distribuição, início do atendimento, troca de mensagens, registro de contexto, transferência quando necessário e conclusão com critérios claros. Use este guia para concluir atendimentos com segurança, evitar conversas sem dono e entender quando um fluxo automatizado pode continuar a jornada depois do encerramento. !Flow do usuário com conversas atuais e ações de atendimento disponíveis Quando usar Use este guia quando você precisa: - iniciar uma conversa que chegou pelo Flow; - entender quando entrar, responder, transferir, sair o... ### Sessão de 24 horas no WhatsApp - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/sessao-de-24-horas-no-whatsapp - Resumo: Como funciona a janela de resposta livre do WhatsApp na Agilize, quando usar modelos aprovados e como evitar conversas paradas. - Seções: Quando usar | Como a sessão funciona | Onde isso aparece na rotina | Mensagem livre ou modelo aprovado | O que significa a conversa ficar parada | Como usar modelos com qualidade | Relação com bot, conclusão e reabertura | Relação com automações e cadências - Conteúdo útil: Sessão de 24 horas no WhatsApp A sessão de 24 horas do WhatsApp define quando a equipe pode responder com mensagem livre e quando precisa usar um modelo aprovado para retomar a conversa. Na Agilize, essa regra afeta atendimento humano, bot, conclusão de atendimento, reabertura de conversa, follow-up comercial, transmissões em massa e automações de CRM. Entender a sessão evita mensagens que não chegam, oportunidades sem retorno e fluxos que dependem de uma retomada que o canal não permite como texto livre. Quando usar Use este guia quando você precisa: - entender por que o WhatsApp pode exigir um modelo aprovado; - retomar uma conversa que ficou parada; - orientar operadores sobre resposta l... ### WhatsApp, chat, SMS e telefone na rotina - URL: https://agilize.app/docs/usuarios/flow-e-atendimento/whatsapp-chat-sms-e-telefone-na-rotina - Resumo: Como escolher e operar cada canal de atendimento na Agilize, mantendo contexto, histórico, responsável e continuidade comercial. - Seções: Quando usar | Onde os canais aparecem | Resumo dos canais | WhatsApp | Quando usar modelo de WhatsApp | LiveChat | Facebook e Instagram | SMS - Conteúdo útil: WhatsApp, chat, SMS e telefone na rotina A Agilize reúne canais diferentes em uma mesma operação, mas cada canal tem finalidade, ritmo e cuidado próprio. Escolher bem entre WhatsApp, chat, SMS e telefone evita retrabalho, melhora a experiência do cliente e mantém o histórico organizado. Use este guia para decidir quando usar cada canal e como manter continuidade entre atendimento, CRM, suporte e próximos passos. !Flow do usuário com conversas por canal e ações de atendimento Quando usar Use este guia quando você precisa: - escolher o melhor canal para falar com o cliente; - entender diferenças entre WhatsApp, chat, SMS e telefone; - saber quando usar modelo/template de WhatsApp; - saber qua... ### Relatórios e BI - URL: https://agilize.app/docs/usuarios/relatorios-bi - Resumo: Guias para criar relatórios, escolher fontes de dados, aplicar filtros e usar exemplos prontos. - Seções: Guias desta seção | Configuração e governança | Próximo passo - Conteúdo útil: Relatórios e BI Esta seção ajuda gestores e administradores a montar análises com fontes, campos, filtros e agregações corretas. Guias desta seção - Relatórios e indicadores. - Criar item de relatório. - Fontes de dados e campos. - Filtros, períodos e agregações. - Exemplos prontos. Configuração e governança Se a dúvida for sobre quais painéis manter, quem pode editar ou como padronizar indicadores da operação, consulte Relatórios e governança. Próximo passo Para transformar indicadores em rotina, acesse Rotinas por perfil. ### Relatórios e indicadores - URL: https://agilize.app/docs/usuarios/relatorios-bi/relatorios-e-indicadores - Resumo: Como acompanhar volume por canal, conversões, oportunidades por etapa, produtividade, tempo de resposta, origem e qualidade para tomar decisões operacionais. - Seções: Quando usar | Visão geral da análise | Onde consultar | Indicadores principais | KPIs por agente e equipe | Relatórios e Insights | Exemplos úteis de análise | Como evitar leitura errada - Conteúdo útil: Relatórios e indicadores Relatórios e indicadores ajudam gestores a acompanhar o que está acontecendo na operação, entender gargalos e decidir onde ajustar atendimento, vendas, suporte, canais, automações e rotina do time. Use este guia para transformar dados da Agilize em decisões práticas: volume por canal, conversões, oportunidades por etapa, produtividade, tempo de resposta, origem e qualidade. Quando usar Use este guia quando você precisa: - acompanhar a performance do time por período, equipe ou agente; - entender se o volume de atendimento cresceu ou caiu; - identificar canais com mais demanda; - acompanhar oportunidades por funil, etapa, origem e responsável; - medir conversões, per... ### Criar item de relatório - URL: https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-criacao-item-relatorio - Resumo: Como criar um item de relatório no BI da Agilize, escolhendo fonte de dados, visualização, eixos, agregações, filtros, configuração visual e painel. - Seções: Antes de começar | Fluxo recomendado | Crie ou selecione o item | Escolha a fonte de dados principal | Escolha o tipo de visualização | Configure colunas, eixos e dimensão | Aplique filtros e período | Ajuste a configuração visual - Conteúdo útil: Criar item de relatório Um item de relatório é um gráfico, número ou tabela criado dentro de Relatórios e Insights. Ele pode ser usado sozinho para análise pontual ou adicionado a um painel para acompanhamento recorrente. Use este guia para criar um item do zero em https://my.agilize.app/report/, entendendo o impacto de cada escolha. Acesso pela tela: barra superior Relatórios > Relatórios e Insights. Pela sidebar lateral, troque para Hub/CRM e abra Relatórios. Antes de começar Defina primeiro a pergunta de negócio. Isso evita criar gráficos bonitos que não ajudam na decisão. Exemplos de boas perguntas: - quantas conversas chegaram por canal nesta semana? - quais origens geraram mais leads... ### Exemplos prontos - URL: https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-exemplos-prontos - Resumo: Biblioteca de exemplos para montar relatórios de atendimento, CRM, suporte, tarefas, ligações e campanhas no BI da Agilize. - Seções: Como copiar um exemplo | Atendimento omnichannel | Volume de conversas por canal | TPA médio por departamento | Atendimentos por agente | Avaliação média por canal | Salas pendentes por período | Suporte e SLA - Conteúdo útil: Exemplos prontos Este guia reúne modelos de relatórios que costumam ser úteis em operações de atendimento, vendas, suporte, voz e campanhas. Use os exemplos como ponto de partida em https://my.agilize.app/report/, ajustando filtros, responsáveis, equipes, canais, funis e períodos conforme a rotina da sua operação. Acesso pela tela: barra superior Relatórios > Relatórios e Insights. Pela sidebar lateral, troque para Hub/CRM e abra Relatórios. Cada exemplo parte das fontes e campos disponíveis no BI da Agilize. Antes de publicar em um painel, revise se a fonte escolhida representa o evento que você quer medir. Como copiar um exemplo ::DocsDiagram --- title: "Como transformar um exemplo em rel... ### Filtros, períodos e agregações - URL: https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-filtros-periodos-agregacoes - Resumo: Como usar período global, filtros por campo, agrupamentos de data e agregações no BI da Agilize sem distorcer a leitura dos relatórios. - Seções: Antes de começar | Como o recorte é aplicado | Período global | Filtros de data | Qual data usar | Agrupamento temporal | Filtros por texto | Filtros por número - Conteúdo útil: Filtros, períodos e agregações Filtros, períodos e agregações definem o recorte real de um relatório. Eles respondem a três perguntas: quais registros entram, qual data define o período e como o valor será calculado. Use este guia ao configurar relatórios em https://my.agilize.app/report/, principalmente quando o mesmo painel precisa comparar atendimento, CRM, suporte, tarefas, ligações e campanhas. Acesso pela tela: barra superior Relatórios > Relatórios e Insights. Pela sidebar lateral, troque para Hub/CRM e abra Relatórios. Antes de começar Antes de aplicar filtros, confirme: - qual pergunta o relatório precisa responder; - qual fonte de dados representa essa pergunta; - qual campo de da... ### Fontes de dados e campos - URL: https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-fontes-dados-campos - Resumo: Referência das fontes de dados do BI da Agilize, com campos disponíveis, tipos, datas, métricas, segmentações e exemplos de uso. - Seções: Como escolher a fonte correta | Tipos de campo | Salas de Conversa | Conversas | Leads | Eventos do Lead | Tarefas | Tickets de Suporte - Conteúdo útil: Fontes de dados e campos As fontes de dados definem o que um relatório consegue responder. Antes de escolher gráfico, filtro ou agregação, escolha a fonte que representa o evento certo: sala aberta, atendimento concluído, lead no funil, mudança de etapa, ticket de suporte, tarefa, ligação ou campanha. Use esta referência ao montar relatórios em https://my.agilize.app/report/. Acesso pela tela: barra superior Relatórios > Relatórios e Insights. Pela sidebar lateral, troque para Hub/CRM e abra Relatórios. A lista de fontes pode variar conforme permissões, projeto, recursos habilitados na conta e escopo de dados do usuário. Usuários não administradores podem ter a consulta limitada por respons... ### RH e jornada - URL: https://agilize.app/docs/usuarios/rh-jornada - Resumo: Guias operacionais de jornada, ponto, ocorrências, aprovações e acompanhamento de RH. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: RH e jornada Use esta seção para orientar a rotina de acompanhamento de jornada, ocorrências e aprovações. Guias desta seção - RH e jornada na rotina. Próximo passo Para configurar perfis, feriados e associações por usuário, acesse RH/Workforce. ### RH e jornada na rotina - URL: https://agilize.app/docs/usuarios/rh-jornada/rh-e-jornada-na-rotina - Resumo: Como colaboradores, gestores e RH usam o Workforce para registrar jornada, controlar status, acompanhar ponto, aprovar ocorrências e consultar relatórios. - Seções: Quando usar | Visão geral da rotina | Papéis na operação | Iniciar a jornada | Usar status durante o dia | Registrar almoço, pausas e exceções | Encerrar expediente | Acompanhar minhas solicitações - Conteúdo útil: RH e jornada na rotina O Workforce da Agilize ajuda a controlar jornada, status operacional, pausas, almoço, exceções e relatórios de ponto dentro da rotina da plataforma. Ele pode ser usado por colaboradores, gestores e RH, com permissões diferentes para cada perfil. Use este guia para entender o dia a dia: iniciar e encerrar jornada, alterar status, justificar exceções, consultar solicitações, revisar relatórios e aprovar ocorrências. Quando usar Use este guia quando você precisa: - registrar início, pausa, almoço e encerramento da jornada; - entender por que a plataforma pediu início de jornada, pausa obrigatória ou justificativa; - trocar status entre online, em call/reunião e pausa; -... ### Rotinas por perfil - URL: https://agilize.app/docs/usuarios/rotinas-por-perfil - Resumo: Checklists recomendados para operador e gestor manterem a operação previsível. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Rotinas por perfil Use estes guias para transformar a documentação em rotina prática para operadores e gestores. Guias desta seção - Rotina recomendada do operador. - Rotina recomendada do gestor. Próximo passo Se a operação ainda não estiver configurada, siga para Configuração. ### Rotina recomendada do gestor - URL: https://agilize.app/docs/usuarios/rotinas-por-perfil/rotina-recomendada-do-gestor - Resumo: Checklist semanal para gestores acompanharem gargalos, oportunidades paradas, qualidade de dados, uso de tags, performance por canal, produtividade e SLA na Agilize. - Seções: Quando usar | Visão geral da rotina | Áreas de apoio do gestor | Checklist semanal | 1. Revisar volume e filas | 2. Revisar oportunidades paradas | 3. Revisar produtividade por agente e equipe | 4. Revisar tempo de resposta e SLA - Conteúdo útil: Rotina recomendada do gestor A rotina do gestor na Agilize deve transformar dados operacionais em ajustes práticos: redistribuir demanda, corrigir gargalos, melhorar qualidade dos registros, orientar operadores e revisar configurações que impactam atendimento, vendas e suporte. Use este guia como checklist semanal para acompanhar filas, oportunidades paradas, qualidade de dados, uso de tags, produtividade, SLA e performance por canal. Quando usar Use este guia quando você precisa: - revisar a semana da operação; - identificar conversas, suportes, tarefas ou oportunidades paradas; - acompanhar produtividade por agente ou equipe; - entender canais com excesso de demanda ou baixa conversão; -... ### Rotina recomendada do operador - URL: https://agilize.app/docs/usuarios/rotinas-por-perfil/rotina-recomendada-do-operador - Resumo: Checklist diário para revisar o Flow, responder pendências, atualizar oportunidades, registrar próximas ações, acompanhar suporte e concluir tarefas na Agilize. - Seções: Quando usar | Visão geral da rotina | Começar o dia | Ordem recomendada de prioridade | Checklist diário | Início do expediente | Durante cada conversa | Durante o acompanhamento comercial - Conteúdo útil: Rotina recomendada do operador A rotina do operador na Agilize deve começar pelo Flow. Ele centraliza conversas distribuídas, mensagens pendentes, tarefas, oportunidades, suporte e outras ações que precisam de acompanhamento. Use este guia como um checklist diário para manter atendimento, CRM e suporte com dono claro, contexto atualizado e próxima ação registrada. !Flow com conversas atuais, tarefas e ações pendentes do operador Quando usar Use este guia quando você precisa: - iniciar o expediente sem depender de busca manual em vários módulos; - revisar conversas que chegaram para você; - responder pendências de clientes; - acompanhar tarefas e oportunidades; - evitar leads sem próxima açã... ### Transmissões e telefonia - URL: https://agilize.app/docs/usuarios/transmissoes-e-telefonia - Resumo: Guias de transmissão em massa, voz, WhatsApp e monitoramento de telefonia. - Seções: Guias desta seção | Próximo passo - Conteúdo útil: Transmissões e telefonia Esta seção concentra guias de canais ativos de grande impacto: transmissões por WhatsApp e voz, além de monitoramento operacional de telefonia. Guias desta seção - Transmissão em massa por WhatsApp e Voz. - Monitoramento de Telefonia. Próximo passo Para preparar canais e regras antes de operar, acesse Canais, WhatsApp e integrações. ### Monitoramento de Telefonia - URL: https://agilize.app/docs/usuarios/transmissoes-e-telefonia/monitoramento-de-telefonia - Resumo: Como acompanhar ramais, filas, chamadas aguardando, chamadas em atendimento e ações de supervisão da operação de voz. - Seções: Onde acessar | O que a tela mostra | Filtros úteis | Como interpretar os ramais | Como interpretar as filas | Transferência assistida e transferência cega | Ações em ramais | Sinais de atenção - Conteúdo útil: Monitoramento de Telefonia O monitoramento de telefonia mostra a operação de voz em tempo real: ramais, filas, chamadas aguardando, chamadas em atendimento e disponibilidade dos agentes. Ele é usado por supervisores e gestores para acompanhar gargalos, identificar indisponibilidade e agir em exceções. Use essa tela para enxergar a operação telefônica. A rotina principal de atendimento deve seguir os fluxos definidos para cada canal e equipe; o monitoramento serve para supervisão, acompanhamento e intervenção quando necessário. ::DocsDiagram --- title: "Leitura operacional de voz" caption: "A tela reúne o estado dos ramais e das filas para apoiar decisões rápidas de supervisão." definition:... ### Transmissão em massa por WhatsApp e Voz - URL: https://agilize.app/docs/usuarios/transmissoes-e-telefonia/transmissao-em-massa-por-whatsapp-e-voz - Resumo: Como preparar listas, criar disparos em massa por WhatsApp ou ligação, acompanhar status, falhas e respostas sem perder governança. - Seções: Quando usar | Visão geral do fluxo | Antes de começar | Criar a lista de transmissão | Criar o disparo | Disparo por WhatsApp | Disparo por Voz | Iniciar, pausar e acompanhar - Conteúdo útil: Transmissão em massa por WhatsApp e Voz Transmissão em massa é o envio planejado de uma comunicação para uma lista de pessoas, empresas, oportunidades ou conversas. Na Agilize, esse recurso pode ser usado para disparos por WhatsApp ou por ligação, sempre com controle de lista, identificador, status, enviados, falhas e acompanhamento do resultado. Use transmissão em massa para campanhas comerciais, reativação de base, avisos operacionais, confirmação de agenda, lembretes, pesquisas e comunicações segmentadas. Evite usar para mensagens sem contexto, bases frias sem governança ou volumes que a equipe não conseguirá atender depois. Quando usar Use este guia quando você precisa: - criar uma list... ## Endpoints por assunto ### Arquivos - Upload - GET /file/upload - Resumo: Documento - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/file-upload/arquivos/get-file-upload - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /file/upload/{_id} - Resumo: Documento - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/file-upload/arquivos/get-file-upload-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - GET /file/upload/download - Resumo: Documento - Download - Detalhe: Baixa um documento do serviço `file/upload` de forma segura. Para arquivos em storage externo, o endpoint redireciona para a URL assinada. Para arquivos locais, o endpoint entrega o binário diretamente. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/file-upload/downloads/get-file-upload-download - Parâmetros: x-api-key (header, obrigatório, string); id (query, obrigatório, string); view (query, opcional, boolean) - Corpo: não declara corpo de requisição - Respostas: 200 Arquivo retornado diretamente pelo servidor.; 302 Redirecionamento para URL assinada do storage externo.; 400 Parâmetros inválidos.; 401 API key ausente ou inválida.; 404 Arquivo não encontrado ou sem acesso. - GET /file/upload/url - Resumo: Documento - Resolver URL final de download - Detalhe: Retorna a URL final de download para um documento do serviço `file/upload`. Quando o arquivo está em storage externo, a resposta já devolve a URL assinada. Quando o arquivo ainda está local, a resposta devolve a rota autenticada `/file/upload/download`. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/file-upload/urls-de-upload/get-file-upload-url - Parâmetros: x-api-key (header, obrigatório, string); id (query, obrigatório, string); view (query, opcional, boolean) - Corpo: não declara corpo de requisição - Respostas: 200 URL resolvida com sucesso.; 400 Parâmetros inválidos.; 401 API key ausente ou inválida.; 404 Arquivo não encontrado ou sem acesso. - POST /file/upload - Resumo: Documento - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/file-upload/arquivos/post-file-upload - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: mimetype, name, size, category, md5, isTemp, canDelete, canDeleteLocal, localDeleteAfter, extStorage - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /file/upload/{_id} - Resumo: Documento - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/file-upload/arquivos/patch-file-upload-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: mimetype, name, size, category, md5, isTemp, canDelete, canDeleteLocal, localDeleteAfter, extStorage - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /file/upload/{_id} - Resumo: Documento - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/file-upload/arquivos/delete-file-upload-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### CRM - Contatos - GET /crm/contact/contact - Resumo: Contato - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-contact/contact/get-crm-contact-contact - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/contact/contact/{_id} - Resumo: Contato - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-contact/contact/get-crm-contact-contact-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /crm/contact/contact - Resumo: Contato - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-contact/contact/post-crm-contact-contact - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /crm/contact/contact/{_id} - Resumo: Contato - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-contact/contact/patch-crm-contact-contact-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: createdAt, name, automations, phones, emails, import, note, companies, leads, socials - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/contact/contact/{_id} - Resumo: Contato - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-contact/contact/delete-crm-contact-contact-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### CRM - Empresas - GET /crm/company/company - Resumo: Empresa - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-company/company/get-crm-company-company - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/company/company/{_id} - Resumo: Empresa - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-company/company/get-crm-company-company-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /crm/company/company - Resumo: Empresa - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-company/company/post-crm-company-company - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /crm/company/company/{_id} - Resumo: Empresa - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-company/company/patch-crm-company-company-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, automations, contacts, leads, phones, emails, socials, import, website, note - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/company/company/{_id} - Resumo: Empresa - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-company/company/delete-crm-company-company-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### CRM - Oportunidades - GET /crm/lead/archiveReason - Resumo: Motivo Arquivamento Lead - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/motivos-de-arquivamento/get-crm-lead-archivereason - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/lead/archiveReason/{_id} - Resumo: Motivo Arquivamento Lead - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/motivos-de-arquivamento/get-crm-lead-archivereason-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - GET /crm/lead/funnel - Resumo: Funil - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/funis/get-crm-lead-funnel - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/lead/funnel/{_id} - Resumo: Funil - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/funis/get-crm-lead-funnel-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - GET /crm/lead/lead - Resumo: Oportunidade - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/oportunidades/get-crm-lead-lead - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/lead/lead/{_id} - Resumo: Oportunidade - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/oportunidades/get-crm-lead-lead-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - GET /crm/lead/source - Resumo: Origem Oportunidade - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/origens/get-crm-lead-source - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/lead/source/{_id} - Resumo: Origem Oportunidade - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/origens/get-crm-lead-source-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - GET /crm/lead/stage - Resumo: Etapa do Funil - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/etapas/get-crm-lead-stage - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/lead/stage/{_id} - Resumo: Etapa do Funil - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/etapas/get-crm-lead-stage-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /crm/lead/archiveReason - Resumo: Motivo Arquivamento Lead - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/motivos-de-arquivamento/post-crm-lead-archivereason - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, funnels - Respostas: 201 created; 401 not authenticated; 500 general error - POST /crm/lead/funnel - Resumo: Funil - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/funis/post-crm-lead-funnel - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, stages, deleted, validatePreviousStageRequirements, allowArchiveWithoutRequiredFields, disableDefaultWonLossStages, hideWonKanban, hideArchivedKanban, deletedAt, deletedBy - Respostas: 201 created; 401 not authenticated; 500 general error - POST /crm/lead/lead - Resumo: Oportunidade - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/oportunidades/post-crm-lead-lead - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json - Respostas: 201 created; 401 not authenticated; 500 general error - POST /crm/lead/source - Resumo: Origem Oportunidade - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/origens/post-crm-lead-source - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, color - Respostas: 201 created; 401 not authenticated; 500 general error - POST /crm/lead/stage - Resumo: Etapa do Funil - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/etapas/post-crm-lead-stage - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /crm/lead/archiveReason/{_id} - Resumo: Motivo Arquivamento Lead - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/motivos-de-arquivamento/patch-crm-lead-archivereason-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, funnels - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - PATCH /crm/lead/funnel/{_id} - Resumo: Funil - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/funis/patch-crm-lead-funnel-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, stages, deleted, validatePreviousStageRequirements, allowArchiveWithoutRequiredFields, disableDefaultWonLossStages, hideWonKanban, hideArchivedKanban, deletedAt, deletedBy - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - PATCH /crm/lead/lead/{_id} - Resumo: Oportunidade - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/oportunidades/patch-crm-lead-lead-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: contacts, automations, companies, phones, emails, socials, name, user, createdBy, import - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - PATCH /crm/lead/source/{_id} - Resumo: Origem Oportunidade - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/origens/patch-crm-lead-source-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, color - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - PATCH /crm/lead/stage/{_id} - Resumo: Etapa do Funil - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/etapas/patch-crm-lead-stage-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: funnel, label, systemName, color, isFinal, finalType, order, transitionRules, deleted, updatedAt - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/lead/archiveReason/{_id} - Resumo: Motivo Arquivamento Lead - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/motivos-de-arquivamento/delete-crm-lead-archivereason-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/lead/funnel/{_id} - Resumo: Funil - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/funis/delete-crm-lead-funnel-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/lead/lead/{_id} - Resumo: Oportunidade - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/oportunidades/delete-crm-lead-lead-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/lead/source/{_id} - Resumo: Origem Oportunidade - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/origens/delete-crm-lead-source-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/lead/stage/{_id} - Resumo: Etapa do Funil - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-lead/etapas/delete-crm-lead-stage-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### CRM - Suporte - GET /crm/support/category - Resumo: Categoria de suporte - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/categorias/get-crm-support-category - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/support/category/{_id} - Resumo: Categoria de suporte - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/categorias/get-crm-support-category-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - GET /crm/support/support - Resumo: Suporte - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/atendimentos/get-crm-support-support - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/support/support/{_id} - Resumo: Suporte - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/atendimentos/get-crm-support-support-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /crm/support/category - Resumo: Categoria de suporte - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/categorias/post-crm-support-category - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, parent, playbook, type - Respostas: 201 created; 401 not authenticated; 500 general error - POST /crm/support/support - Resumo: Suporte - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/atendimentos/post-crm-support-support - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: customer, room, contact, number, subject, category, subCategory, department, team, user - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /crm/support/category/{_id} - Resumo: Categoria de suporte - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/categorias/patch-crm-support-category-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, parent, playbook, type - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - PATCH /crm/support/support/{_id} - Resumo: Suporte - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/atendimentos/patch-crm-support-support-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: customer, room, contact, number, subject, category, subCategory, department, team, user - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/support/category/{_id} - Resumo: Categoria de suporte - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/categorias/delete-crm-support-category-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/support/support/{_id} - Resumo: Suporte - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-support/atendimentos/delete-crm-support-support-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### CRM - Tags - GET /crm/tag/tag - Resumo: Tag - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-tag/tag/get-crm-tag-tag - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/tag/tag/{_id} - Resumo: Tag - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-tag/tag/get-crm-tag-tag-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /crm/tag/tag - Resumo: Tag - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-tag/tag/post-crm-tag-tag - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, color, ent, deleted, deletedAt, deletedBy - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /crm/tag/tag/{_id} - Resumo: Tag - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-tag/tag/patch-crm-tag-tag-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, color, ent, deleted, deletedAt, deletedBy - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/tag/tag/{_id} - Resumo: Tag - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-tag/tag/delete-crm-tag-tag-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### CRM - Timeline - GET /crm/timeline/timeline - Resumo: Linha do Tempo - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-timeline/timeline/get-crm-timeline-timeline - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /crm/timeline/timeline/{_id} - Resumo: Linha do Tempo - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-timeline/timeline/get-crm-timeline-timeline-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /crm/timeline/timeline - Resumo: Linha do Tempo - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-timeline/timeline/post-crm-timeline-timeline - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: contact, lead, task, pipeline, pipelineItem, pipelineStage, user, tags, begin, end - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /crm/timeline/timeline/{_id} - Resumo: Linha do Tempo - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-timeline/timeline/patch-crm-timeline-timeline-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: contact, lead, task, pipeline, pipelineItem, pipelineStage, user, tags, begin, end - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /crm/timeline/timeline/{_id} - Resumo: Linha do Tempo - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/crm-timeline/timeline/delete-crm-timeline-timeline-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### Mensagens - Chat - GET /messenger/chat/messageTemplate - Resumo: Modelo de Mensagem - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/modelos-de-mensagem/get-messenger-chat-messagetemplate - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /messenger/chat/messageTemplate/{_id} - Resumo: Modelo de Mensagem - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/modelos-de-mensagem/get-messenger-chat-messagetemplate-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - GET /messenger/chat/room - Resumo: Sala de Conversa - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/salas-de-conversa/get-messenger-chat-room - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /messenger/chat/room/{_id} - Resumo: Sala de Conversa - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/salas-de-conversa/get-messenger-chat-room-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /messenger/chat/message/send - Resumo: Enviar mensagem (bot) - Detalhe: Envia uma mensagem em nome do bot (`fromBot: true`), persiste em `messenger/chat/message` e faz dispatch externo (WhatsApp/Facebook/Instagram) conforme o canal da room. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/mensagens/post-messenger-chat-message-send - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: room, message, file, files - Respostas: 200 Mensagem processada e persistida; 400 Payload inválido; 401 API key ausente ou inválida; 403 Sala não pertence ao projeto do usuário; 404 Sala não encontrada; 409 Configuração do canal não encontrada; 502 Falha ao enviar para o provider externo - POST /messenger/chat/messageTemplate - Resumo: Modelo de Mensagem - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/modelos-de-mensagem/post-messenger-chat-messagetemplate - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, language, category, bodyText, body, header, footer, buttons, business, phone - Respostas: 201 created; 401 not authenticated; 500 general error - POST /messenger/chat/room - Resumo: Sala de Conversa - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/salas-de-conversa/post-messenger-chat-room - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: guest, users, prefUser, owner, prefUserPendAttr, histUsers, tags, conversationDetailTags, department, contact - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /messenger/chat/messageTemplate/{_id} - Resumo: Modelo de Mensagem - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/modelos-de-mensagem/patch-messenger-chat-messagetemplate-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, language, category, bodyText, body, header, footer, buttons, business, phone - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - PATCH /messenger/chat/room/{_id} - Resumo: Sala de Conversa - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/salas-de-conversa/patch-messenger-chat-room-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: guest, users, prefUser, owner, prefUserPendAttr, histUsers, tags, conversationDetailTags, department, contact - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /messenger/chat/messageTemplate/{_id} - Resumo: Modelo de Mensagem - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/modelos-de-mensagem/delete-messenger-chat-messagetemplate-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /messenger/chat/room/{_id} - Resumo: Sala de Conversa - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/salas-de-conversa/delete-messenger-chat-room-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### Mensagens - Meta - GET /messenger/meta/phone - Resumo: WhatsApp - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-meta/phone/get-messenger-meta-phone - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /messenger/meta/phone/{_id} - Resumo: WhatsApp - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-meta/phone/get-messenger-meta-phone-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /messenger/meta/phone - Resumo: WhatsApp - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-meta/phone/post-messenger-meta-phone - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: phone, phoneNumberId, status, business, flow, users, meta, isRegistered, integrationType, sendAgentName - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /messenger/meta/phone/{_id} - Resumo: WhatsApp - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-meta/phone/patch-messenger-meta-phone-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: phone, phoneNumberId, status, business, flow, users, meta, isRegistered, integrationType, sendAgentName - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /messenger/meta/phone/{_id} - Resumo: WhatsApp - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-meta/phone/delete-messenger-meta-phone-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### Mensagens - SMS - GET /messenger/sms/send - Resumo: Envio de SMS - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-sms/send/get-messenger-sms-send - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /messenger/sms/send/{_id} - Resumo: Envio de SMS - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-sms/send/get-messenger-sms-send-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /messenger/sms/send - Resumo: Envio de SMS - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-sms/send/post-messenger-sms-send - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: phone, content, user, room, dt, extId, hasReply, extCodStaDetail, extCodSta, pendingRev - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /messenger/sms/send/{_id} - Resumo: Envio de SMS - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-sms/send/patch-messenger-sms-send-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: phone, content, user, room, dt, extId, hasReply, extCodStaDetail, extCodSta, pendingRev - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /messenger/sms/send/{_id} - Resumo: Envio de SMS - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-sms/send/delete-messenger-sms-send-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### Mensagens - WhatsApp - GET /messenger/whatsapp/send - Resumo: Envio WhatsApp - Busca e listagem de registros - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-whatsapp/send/get-messenger-whatsapp-send - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 500 general error - GET /messenger/whatsapp/send/{_id} - Resumo: Envio WhatsApp - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-whatsapp/send/get-messenger-whatsapp-send-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - POST /messenger/whatsapp/send - Resumo: Envia um template de WhatsApp para o destino informado. Use `persistOnRoom` para tambem registrar o envio no historico da conversa quando aplicavel. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-whatsapp/send/post-messenger-whatsapp-send - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json - Respostas: 201 created; 401 not authenticated; 500 general error - PATCH /messenger/whatsapp/send/{_id} - Resumo: Envio WhatsApp - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-whatsapp/send/patch-messenger-whatsapp-send-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: destination, phone, varHeader, varsBody, varOrder, template, dt, extId, status - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error - DELETE /messenger/whatsapp/send/{_id} - Resumo: Envio WhatsApp - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-whatsapp/send/delete-messenger-whatsapp-send-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 500 general error ### Usuários - GET /user/user - Resumo: Usuário - Busca e listagem de registros. Este endpoint REST possui limite rígido de 1 requisição a cada 10 segundos por IP. Para integrações, prefira sincronização periódica via cron ou rotina similar, evitando consultas em alta frequência. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/user-user/usuarios/get-user-user - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 429 Limite excedido para este endpoint REST. Maximo de 1 requisicao a cada 10 segundos por IP.; 500 general error - GET /user/user/{_id} - Resumo: Usuário - Retornar registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/user-user/usuarios/get-user-user-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 429 Limite excedido para este endpoint REST. Maximo de 1 requisicao a cada 10 segundos por IP.; 500 general error - POST /user/user - Resumo: Usuário - Criação de novo registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/user-user/usuarios/post-user-user - Parâmetros: x-api-key (header, obrigatório, string); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, email, password, group, ownerCompany, currentProject, primaryTeamOrg, isTeamSupervisor, role, additionalInfo - Respostas: 201 created; 401 not authenticated; 429 Limite excedido para este endpoint REST. Maximo de 1 requisicao a cada 10 segundos por IP.; 500 general error - PATCH /user/user/{_id} - Resumo: Usuário - Atualização de campos do registro. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/user-user/usuarios/patch-user-user-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: obrigatório; application/json; campos principais: name, email, password, group, ownerCompany, currentProject, primaryTeamOrg, isTeamSupervisor, role, additionalInfo - Respostas: 200 success; 401 not authenticated; 404 not found; 429 Limite excedido para este endpoint REST. Maximo de 1 requisicao a cada 10 segundos por IP.; 500 general error - DELETE /user/user/{_id} - Resumo: Usuário - Exclusão do registro - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/user-user/usuarios/delete-user-user-id - Parâmetros: x-api-key (header, obrigatório, string); _id (path, obrigatório, integer); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 401 not authenticated; 404 not found; 429 Limite excedido para este endpoint REST. Maximo de 1 requisicao a cada 10 segundos por IP.; 500 general error ### Voz - PBX - GET /voice/pbx/cdr/cdr - Resumo: Registro de Chamada - Busca e listagem de registros - Detalhe: Registro de Chamada - Busca e listagem de registros. Este endpoint pode ser utilizado para busca por range de data **(no máximo 7 dias)** ou por **uniqueid**. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/voice-pbx/chamadas/get-voice-pbx-cdr-cdr - Parâmetros: x-api-key (header, obrigatório, string); $limit (query, opcional, integer); $skip (query, opcional, integer); $sort (query, opcional, object); filter (query, opcional, object); content-type (header, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 success; 400 bad request; 401 not authenticated; 500 general error - GET /voice/pbx/cdr/download - Resumo: Registro de Chamada - Download Gravação - Detalhe: Este endpoint permite fazer o download de uma gravação de chamada. O usuário tem um limite mensal de **20.000** downloads. Caso esse limite não seja suficiente, por favor, entre em contato com o gestor de contas. - Docs: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/voice-pbx/chamadas/get-voice-pbx-cdr-download - Parâmetros: x-api-key (header, obrigatório, string); uniqueid (query, obrigatório, string) - Corpo: não declara corpo de requisição - Respostas: 200 Download do arquivo CDR bem-sucedido.; 405 You have exceeded the monthly limit of [LIMIT] download requests. Talk to your account manager for more information.; 410 CDR not found, verify uniqueid.; 411 Recording not available for this CDR