> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://ajuda.notificacoesinteligentes.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Make | Guia de uso, autenticação e visão geral ||| Recomendamos que esta integração seja feita por alguém que domine a linguagem de programação. # ${color}[#ad65cd](Ideia do APP: O que esperar e funcionamento)   * O Custom App do NI (Notificações Inteligentes) é uma ferramenta que permite integrar e automatizar algumas das funcionalidades da sua conta NI diretamente nos seus fluxos de trabalho (workflows). * A ideia central é que você possa manipular os principais dados da sua plataforma NI (como Integrações, e Leads) usando operações padronizadas (CRUD: Criar, Buscar, Atualizar e Deletar). A chave para essa manipulação são os Identificadores Únicos (IDs). ** ** --- ###### ${color}[#ad65cd](PRINCIPAIS CONCEITOS:)    **Base de Operação:** Quase todas as operações no App giram em torno de um ID. * Para gerenciar uma Integração, você precisa do seu ID. * Para editar um Lead, você precisa do ID do Lead. ###### ${color}[#ad65cd](TRATAMENTOS DE ERROS E CONFIRMAÇÕES:)   **Confirmação de Sucesso:** Todas as operações de criação, edição e exclusão são validadas pela plataforma. Ao serem bem-sucedidas, retornam uma mensagem de confirmação explícita, garantindo ao usuário que a ação foi concluída conforme esperado. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/integracao-criada-com-sucesso_y1h11c.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/nome-atualizado-com-sucesso_8mlv4e.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/integracao-apagada-com-sucesso_1l8ttv.png) Em caso de falha, o App fornece respostas de erros detalhadas e estruturadas, incluindo: **Descrição do Erro**: Uma mensagem legível que explica a natureza do problema.   **Código de Erro HTTP**: O código de status padrão, permitindo uma depuração técnica eficiente e a construção de lógicas condicionais robustas dentro do fluxo do Make.   Quando relacionado a alguma regra própria da API, na maioria dos casos ela retorna o motivo do erro detalhado, deixando ainda mais claro. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/resposta-de-erro-da-api_p2mlvr.png) Em todos os erros são retornados o código de erro. No caso de exemplo abaixo, retornou 404 (Not Found), pois não encontrou nenhum ID relacionado ao que tentamos apagar na conta. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/exemplo-de-erro_11i05g8.png) --- ###### ${color}[#ad65cf](DADOS ADICIONAIS:) Além dos IDs, o App permite trabalhar com uma gama de dados complementares (opcionais) para enriquecer suas automações, como Tags, Variáveis Customizadas, Filtros (Filters) e Relacionamentos (Include Relationships).   Em campos de busca por exemplo, caso plausível, existe a opção de receber dados adicionais na requisição.   Filtros (Filters) permitem a filtragem de dados a serem recebidos. Pode-se filtrar por um ou mais de um filtro ao mesmo tempo.   Já a Inclusão de Relacionamentos (Include Relationships) permite adicionar mais dados a serem recebidos pela API. Também pode ser usado mais de uma opção para fazer a busca ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/incluir-relacionamentos-e-filt_jxazk2.png) Em resumo, o App transforma a API do NI em blocos visuais e intuitivos no Make, onde a principal moeda de operação são os IDs, permitindo que você construa automações personalizadas para gerenciar sua comunicação e base de contatos de forma satisfatória.   --- ###### ${color}[#ad65cf](GUIA DE AUTENTICAÇÃO DO APP DO NI:) **Bem-vindo ao Make App do Notificações Inteligentes**! Este guia irá te ajudar a gerar e configurar sua API Key (Bearer Token) para autenticar e utilizar todas as funcionalidades do seu App do NI de forma segura.   --- ###### ${color}[#ad65cf](ACESSANDO O PAINEL DE NOTIFICAÇÕES INTELIGENTES:)   1. Abra seu navegador e acesse o site [Notificações Inteligentes]((https://notificacoesinteligentes.com)) 2. Clique em** "Entrar"** e faça login com a sua conta.   Certifique-se de usar a conta correta que tem acesso às organizações que deseja gerenciar via API. ---   ###### ${color}[#ad65cf](GERANDO A API KEY (BEARER TOKEN)) 1. Após login, no menu superior, clique em "**Organizações"**. 2. Selecione a organização desejada. 3. Acesse "**Configurações"**. 4. Procure a seção** "Chave de API"**. 5. Clique em "**Gerar nova chave"**. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/generatekey_vaoyz9.png) 6. Uma caixa de diálogo será exibida: ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/token_1lmdeh9.png) * Marque a caixinha confirmando que você guardou a chave em um local seguro. * Clique em "**Concluir".**   A chave gerada será usada como Bearer Token para autenticação do App. ||| Atenção: Guarde essa chave com segurança! Não compartilhe publicamente. --- ### ${color}[#ad65cf](AUTENTICANDO O APP NO MAKE:)   1. Clique em qualquer nó do NI para abrir a página que dê acesso a opção "**Create Connection"**. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/botao-de-criar-conexao-make_14db6gj.png) 2. Cole a chave gerada no site da Notificações Inteligentes. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/captura-de-tela-de-2025-10-10-_105pqci.png) 3. Salve as configurações. 4. Caso haja algum problema com a chave API, uma mensagem de erro aparecerá. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/exemplo-de-key-invalida_bejc9z.png) --- **Caso ocorra algum erro de autenticação, verifique se:** * O Bearer Token foi copiado corretamente. * A chave não expirou. * Sua conta tem permissão para acessar a organização escolhida. --- 5. Caso tenha mais de uma organização, é possível adicionar mais de uma chave e organizar as credenciais conforme cada organização. Para facilitar a identificação basta renomear cada credencial. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/adicionar-mais-de-uma-api_1nhm2p5.png) --- ###### ${color}[#ad65cf](TESTANDO A CONEXÃO:) ######   1. Crie uma ação de teste no App, como "**Buscas Todas Integrações**"; 2. Execute a ação; 3. Se tudo estiver correto, você verá os dados retornados da API. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/teste-bem-sucedido_10nzyfi.png)   ###### ${color}[#ad65cf](PRONTO!)   Agora você pode utilizar seu App do NI para manipular e automatizar algumas ações no Make. --- # ${color}[#ad65cf](Guia de uso - Leads (MAKE) )   * O recurso Leads permite cadastrar, buscar, editar, apagar e gerenciar listas de leads (contatos) em sua plataforma diretamente pelo n8n, com suporte a variáveis customizadas, tags e filtros avançados.   --- ### ${color}[#ad65cf](OPERAÇÕES DISPONÍVEIS:) ---   ###### ${color}[#ad65cf](CRIAR LEAD:) Cria um novo lead (contato) no sistema.   ###### ${color}[#ad65cf](CAMPOS OBRIGATÓRIOS:) * **Nome:** Nome completo do lead. * **Telefone:** Número de telefone, incluindo DDD e código de região. * **E-mail**: Endereço de e-mail do lead. ###### ${color}[#ad65cf](CAMPOS OPCIONAIS:) * **Anotações:** Observações adicionais sobre o lead. * **Variáveis Customizadas:** Permite adicionar variáveis extras personalizadas para cada lead (ex: CPF, data de nascimento, etc). * **Tags:** Adicione palavras-chave para agrupar ou categorizar leads (ex: "cliente VIP", "prospecto"). * **Dados de Rastreio**: Adiciona dados rastreáveis sobre determinadas ações em alguns sites. ###### ${color}[#ad65cf](COMO USAR:) Selecione o **"Resource Lead"**, depois **“Criar Lead”** preencha os campos obrigatórios e, se desejar, inclua notas, tags ou variáveis customizadas. Execute para cadastrar o lead. ---   ###### ${color}[#ad65cf](PONTOS IMPORTANTES:) Caso queira adicionar uma variável customizada, o valor do **SLUG** e o **VALUE** será necessário. ||| Atenção: o campo "value" da "custom variable" tem que ser sempre do tipo correto da variável customizada. Uma variável customizada do tipo CPF, tem que conter um CPF, não pode conter texto. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/criando-lead-exemplo_1d9moi5.png) --- ###### ${color}[#ad65cf](ATUALIZAR LEAD:) Permite atualizar os dados de um lead existente. ---   ###### ${color}[#ad65cf](CAMPOS OBRIGATÓRIOS:) * **Lead ID**: Identificador do lead a ser editado; * **Name**: Nome atualizado do lead; * **E-mail:** E-mail atualizado do lead.   ###### ${color}[#ad65cf](CAMPOS OPCIONAIS:) Atualize ou adicione observações. * **Custom Variables:** Altere ou adicione variáveis personalizadas.   ###### ${color}[#ad65cf](COMO USAR:) Selecione o "**Resource Lead"**, depois “**Update Lead**” preencha os campos obrigatórios e, se desejar, inclua notas, ou variáveis customizadas. Execute para cadastrar o lead. * **Notes:** Atualize ou adicione observações; * **Custom Variables:** Altere ou adicione variáveis personalizadas.   ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/atualizando-lead_1iq1wlb.png) --- ###### ${color}[#ad65cf](CRIAR OU ATUALIZAR LEAD:) Permite criar ou atualizar os dados de um lead existente.   A API analisa o número de telefone inserido pra analisar se o lead existe ou não, automaticamente. Se o lead não existir é criado um lead, se o lead existir ele é atualizado com os novos dados inseridos.   ||| Atenção: o campo “Phone” deve conter o código de país juntamente com o “+” antes dos dados de telefone. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/criar-lead-ou-atualizar-exempl_29fodi.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/criar-lead-ou-atualizar-exempl_wusv0o.png) --- ###### ${color}[#ad65cf](ADICIONAR TAGS A UM LEAD:) Adiciona Tags a um determinado lead.   ###### ${color}[#ad65cf](CAMPOS OBRIGATÓRIOS): * **Lead ID**: Identificador do lead a ser editado; * **Tags:** Tags a serem adicionadas.   ###### ${color}[#ad65cf](COMO USAR:) Selecione "**Adicionar Tags a um Lead**" preecha os campos “**Lead ID**” e marque o campo “**Tags**” e execute.   As tags selecionáveis são todas as tags disponíveis e criadas na conta associada ao token. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/adicionando-tags-exemplo_177klv.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/adicionando-tags-exemplo-2_e2vl5c.png) --- ###### ${color}[#ad65cf](ATUALIZAR TAGS DE UM LEAD:) Atualiza as Tags de um lead. Nesse caso as tags que existirem no lead, serão removidas e substituídas pelas tags colocadas no campo “**Tags**”.   ###### ${color}[#ad65cf](CAMPOS OBRIGATÓRIOS:) * **Lead ID**: Identificador do lead a ser editado. * **Tags:** Novas tags que vão atualizar o lead.   ###### ${color}[#ad65cf](COMO USAR:) Selecione "**Update Tags from Lead**" preecha os campos “**Lead ID**” e o campo “**Tags**” e execute.   ||| Atenção: a atualização de tags de um lead, remove todas as tags anteriores e adiciona as tags definidas pelo usuário nessa opção. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/atualizando-tags-de-um-lead-2_wmvfuz.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/atualizando-tags-de-um-lead-1_h7pklw.png) --- ###### ${color}[#ad65cf](APAGAR TAGS DE UM LEAD:) Remove as tags escolhidas de determinado lead. ###### ${color}[#ad65cf](CAMPOS OBRIGATÓRIOS:) * **Lead ID:** Identificador do lead a ser editado; * **Tags:** Novas tags que vão atualizar o lead.   ###### ${color}[#ad65cf](COMO USAR:) Selecione "**Apagar Tags de um Lead**" preecha os campos “**ID do Lead**” e o campo “**Tags**” e execute.     ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/apagando-tags-exemplo-2_1y3ti2t.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/apagando-tags-exemplo-1_qbg7o.png) --- ###### ${color}[#ad65cf](BUSCAR TODOS OS LEADS:) Lista todos os leads cadastrados no sistema.   ###### ${color}[#ad65cf](CAMPOS OPCIONAIS:) * **Filters**: Permite filtrar por nome, telefone, e-mail ou tag; * I**nclude Relationships**: Marque para trazer dados relacionados, como listas, tags e fonte das listas.   ###### ${color}[#ad65cf](COMO USAR:) Selecione "**Buscar Todos os Leads**", defina os filtros desejados (ou deixe em branco para listar todos) e execute.   ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/buscando-todos-os-leads_5nnir9.png) --- ######   ###### ${color}[#ad65cf](BUSCAR LEAD PELO ID:) Retorna os dados completos de um lead específico a partir do seu identificador único.   ###### ${color}[#ad65cf](CAMPOS OBRIGATÓRIOS:) * **ID do Lead**: Insira o ID do lead desejado (pode ser obtido ao listar todos).   ###### ${color}[#ad65cf](CAMPOS OPCIONAIS:) * I**ncluir Relacionamentos:** Escolha trazer listas, tags ou usuários relacionados.   ###### ${color}[#ad65cf](COMO USAR:) Selecione "**Buscar Lead Por ID**", informe o ID do lead e, se quiser, marque os relacionamentos a incluir. Execute para ver detalhes completos. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/buscar-lead-por-id-exemplo-2_1xlb4od.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/buscar-lead-pelo-id_bhaev0.png) --- ###### ${color}[#ad65cf](APAGAR LEAD:) Remove um lead de forma permanente do sistema.   ###### ${color}[#ad65cf](CAMPO OBRIGATÓRIO:) * **Lead ID**: Identificador do lead a ser removido.   ###### ${color}[#ad65cf](COMO USAR:) Selecione "**Apagar Lead**", informe o ID do lead e execute. Uma mensagem de confirmação será exibida se a operação for bem-sucedida. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/apagar-lead-exemplo_1b9wppv.png) **PARA MAIS INFORMAÇÕES SOBRE LEADS NO NI:** Consulte: [__https://ajuda.notificacoesinteligentes.com/pt-br/article/gerenciamento-de-leads-1x8lj7m/__](https://ajuda.notificacoesinteligentes.com/pt-br/article/gerenciamento-de-leads-1x8lj7m/)