Conta, integrações e API

61 artigos Vitor Por Vitor

Como criar sua própria Central de Ajuda com o Papo Global

Com o Papo Global (https://papo.global/), você pode criar sua própria Central de Ajuda usando o módulo Help Center integrado à plataforma. Essa ferramenta permite desenvolver portais de conhecimento, organizar artigos em categorias e oferecer um canal de autoatendimento completo para seus clientes e equipe interna, reduzindo a carga sobre seus agentes de suporte. Uma Central de Ajuda bem estruturada é fundamental para escalar o atendimento ao cliente. Ela centraliza informações importantes, tutoriais e respostas para as perguntas mais comuns, permitindo que os usuários encontrem soluções por conta própria, a qualquer hora do dia. Na Papo Global, essa funcionalidade foi projetada para ser simples e diretamente conectada ao seu ecossistema de atendimento. Componentes da Central de Ajuda A estrutura da Central de Ajuda na Papo Global é organizada em três níveis principais, garantindo que a informação seja fácil de encontrar e gerenciar. | Componente | Descrição | Exemplo de Uso | | :--- | :--- | :--- | | Portal | É o site principal da sua Central de Ajuda. Você pode ter um ou mais portais, por exemplo, um para clientes e outro para treinamento interno. | ajuda.suaempresa.com | | Categoria | São as seções que organizam os artigos dentro de um portal. Elas funcionam como pastas para agrupar conteúdos por tema. | "Faturamento", "Primeiros Passos", "Integrações" | | Artigo | É a página de conteúdo em si, contendo o texto, tutoriais e respostas. Cada artigo pertence a uma categoria. | "Como emitir a segunda via do boleto" | Passo a passo para criar sua Central de Ajuda Criar e publicar sua base de conhecimento com o Papo Global é um processo direto. Siga os passos abaixo para configurar seu portal de autoatendimento. 1. Acesse o Módulo Help Center No painel da Papo Global, localize e acesse o módulo "Help Center". Lá, você terá a visão geral de todos os seus portais, categorias e artigos. 2. Crie seu Primeiro Portal O portal é a casa da sua Central de Ajuda. Comece criando um novo portal e dando a ele um nome claro, como "Central de Ajuda - Clientes" ou "Base de Conhecimento Interna". Este será o ponto de partida para toda a sua documentação. 3. Defina as Categorias Com o portal criado, o próximo passo é organizar a estrutura. Pense nos principais temas sobre os quais seus clientes ou sua equipe têm dúvidas. Crie categorias para cada um desses temas. Boas categorias ajudam os usuários a navegar intuitivamente pelo conteúdo. Exemplos de categorias: - Para clientes: Primeiros Passos, Dúvidas sobre Pagamento, Guia de Produtos, Solução de Problemas. - Para equipe interna: Processos de Vendas, Scripts de Atendimento, Políticas da Empresa, Treinamento de Ferramentas. 4. Escreva e Salve os Artigos como Rascunho Dentro das categorias, comece a criar os artigos. A plataforma permite que você escreva o conteúdo e o salve como rascunho (draft). Isso é útil para preparar o material com calma, revisar e aprovar antes de torná-lo público. Use uma linguagem clara, frases curtas e formate o texto para facilitar a leitura. 5. Publique os Artigos Quando um artigo estiver pronto, basta alterar seu status de "rascunho" para "publicado" (published). A partir desse momento, ele ficará visível para os usuários que acessarem seu portal da Central de Ajuda. Você pode atualizar, editar ou remover artigos a qualquer momento. Para quem é a Central de Ajuda? O módulo Help Center é uma ferramenta versátil que atende a diversas necessidades de um negócio em crescimento. - Empresas que buscam escalar o suporte: Reduza o volume de tickets repetitivos, permitindo que os clientes encontrem respostas para dúvidas comuns por conta própria. - Equipes de Sucesso do Cliente (Customer Success): Ofereça um recurso de onboarding e educação contínua para os usuários, aumentando a adoção e a satisfação com o produto. - Operações com equipes remotas ou grandes: Crie uma base de conhecimento interna para padronizar processos, treinar novos colaboradores e garantir que todos tenham acesso rápido às informações corretas. - Negócios que precisam de atendimento 24/7: Uma Central de Ajuda funciona como um agente de suporte sempre ativo, oferecendo ajuda fora do horário comercial. Perguntas Frequentes Posso ter mais de um portal na minha Central de Ajuda? Sim, a plataforma permite a criação de múltiplos portais. Isso é ideal para separar a base de conhecimento voltada para clientes externos daquela destinada ao uso interno da sua equipe, por exemplo. A Central de Ajuda é integrada com a IA da Papo? Sim. Os artigos criados na sua Central de Ajuda podem ser usados como fonte de conhecimento para alimentar a inteligência artificial da Papo Global. Isso permite que o chatbot forneça respostas automáticas mais precisas e contextualizadas, baseadas na sua documentação oficial. Meus clientes podem pesquisar nos artigos? Sim. A funcionalidade de busca está integrada ao portal, permitindo que os usuários digitem palavras-chave para encontrar rapidamente os artigos mais relevantes para suas dúvidas. Como posso organizar o conteúdo dos artigos? Você pode estruturar o conteúdo usando títulos, parágrafos, listas e tabelas para tornar a informação clara e fácil de consumir. Uma boa formatação é essencial para a experiência do leitor. Posso criar uma central de ajuda apenas para minha equipe? Com certeza. O módulo é perfeito para criar uma base de conhecimento interna. Você pode centralizar tutoriais sobre o uso de ferramentas, guias de processos, políticas da empresa e outras informações importantes para o dia a dia da sua operação. A Central de Ajuda é um recurso pago? O módulo Help Center faz parte do ecossistema de ferramentas da Papo Global. Para detalhes sobre quais funcionalidades estão incluídas em cada plano, consulte a página de preços no site oficial. Leia também - Alimentando a IA: Como Criar uma Base de Conhecimento para Respostas Automáticas - Visão geral do painel do Papo Global: menu lateral e módulos Comece grátis no Papo Global → O primeiro usuário é grátis e o cadastro não exige cartão de crédito.

Como integrar sua Google Agenda para sincronizar seus agendamentos

Sim, você pode integrar sua conta Google Agenda diretamente à plataforma Papo (https://papo.global/) para automatizar e sincronizar seus agendamentos. A integração permite que o sistema leia sua disponibilidade em tempo real e crie eventos automaticamente no seu calendário, eliminando a necessidade de agendamentos manuais e evitando conflitos de horários. Conectar sua Google Agenda ao Papo é um passo fundamental para automatizar o atendimento e otimizar a gestão de tempo da sua equipe. Essa integração transforma a maneira como você marca compromissos, permitindo que a Inteligência Artificial da Papo agende para você diretamente nas conversas de WhatsApp, com base na sua disponibilidade real. | Funcionalidade | Descrição | | :--- | :--- | | Sincronização de Disponibilidade | O Papo lê os horários ocupados na sua Google Agenda para saber quando você ou sua equipe não estão disponíveis, evitando oferecer horários já preenchidos. | | Criação Automática de Eventos | Quando um agendamento é confirmado (seja pela IA no WhatsApp ou por um atendente), um evento é criado automaticamente na sua Google Agenda com os detalhes do cliente. | | Atendimento Inteligente | A Inteligência Artificial da Papo utiliza a agenda sincronizada para sugerir horários livres aos clientes durante uma conversa, realizando o agendamento completo. | | Visão Centralizada | Todos os compromissos ficam visíveis tanto no módulo de Atendimentos da Papo quanto na sua Google Agenda, mantendo a organização em um só lugar. | Como funciona a integração com a Google Agenda A integração funciona como uma ponte de duas vias entre a Papo e sua conta Google. 1. Leitura de Disponibilidade: Uma vez conectada, a Papo passa a verificar sua Google Agenda em tempo real. Se você tem uma reunião pessoal ou qualquer outro compromisso marcado, o sistema entende que aquele horário está indisponível e não o oferecerá a um cliente que esteja tentando agendar um serviço. 2. Criação de Eventos: Quando um cliente solicita um agendamento pelo WhatsApp, a IA da Papo entra em ação. Ela consulta os horários livres (considerando os compromissos já existentes na sua Google Agenda e a jornada de trabalho configurada no módulo de Atendimentos), oferece as opções disponíveis e, após a confirmação do cliente, cria o evento diretamente na sua Google Agenda. Esse processo elimina o trabalho manual de "copiar e colar" informações entre o chat e a agenda, reduzindo erros humanos e garantindo que nenhum agendamento seja perdido ou sobreposto. Passo a passo para conectar sua Google Agenda Configurar a integração é um processo simples. Embora a localização exata possa variar ligeiramente dependendo das atualizações da plataforma, o fluxo geral é o seguinte: 1. Acesse as Configurações de Integração: Dentro da plataforma Papo, navegue até a área de configurações. A opção de conectar a agenda geralmente está localizada no módulo de Atendimentos ou em uma seção geral de Integrações no seu perfil ou nas configurações da conta. 2. Localize a Opção Google Agenda: Procure pelo ícone ou pela opção "Google Agenda" ou "Google Calendar" e clique para iniciar o processo de conexão. 3. Conecte sua Conta Google: Você será redirecionado para uma tela de login do Google. Insira o e-mail e a senha da conta Google que você deseja sincronizar com a Papo. Pode ser uma conta pessoal (@gmail.com) ou uma conta profissional do Google Workspace. 4. Autorize as Permissões: O Google solicitará que você autorize a Papo a acessar e gerenciar seu calendário. É crucial conceder essas permissões. A plataforma precisa delas para ler seus horários ocupados e para criar novos eventos em seu nome. A Papo utiliza essas permissões estritamente para a funcionalidade de agendamento. 5. Verifique o Status da Conexão: Após a autorização, você será redirecionado de volta para a plataforma Papo. A seção de integração deverá agora mostrar um status de "Conectado", indicando que a sincronização está ativa. Com a conexão estabelecida, sua agenda está pronta para ser gerenciada de forma inteligente pela Papo. Para quem é esta integração? Essa funcionalidade é especialmente valiosa para qualquer negócio que opere com base em agendamentos e queira otimizar o processo, liberando a equipe de tarefas repetitivas. Alguns exemplos incluem: - Clínicas e Consultórios: Médicos, dentistas, psicólogos e fisioterapeutas que precisam gerenciar agendas de pacientes. - Salões de Beleza e Barbearias: Profissionais que agendam cortes, tratamentos e outros serviços estéticos. - Escritórios de Advocacia e Contabilidade: Para marcar reuniões, consultorias e atendimentos com clientes. - Prestadores de Serviço: Técnicos, consultores e instrutores que realizam visitas ou sessões com hora marcada. - Pet Shops e Clínicas Veterinárias: Para agendar consultas, banhos, tosas e outros cuidados com animais. Perguntas Frequentes (FAQ) A integração funciona com qualquer conta Google? Sim, a integração é compatível tanto com contas pessoais do Google (@gmail.com) quanto com contas profissionais do Google Workspace (seu-email@suaempresa.com). O que acontece se eu já tiver um compromisso pessoal na minha agenda? O Papo o identificará como um horário ocupado e não oferecerá esse slot para clientes. A integração respeita todos os eventos existentes no seu calendário, garantindo sua privacidade e evitando conflitos entre compromissos pessoais e profissionais. Posso conectar mais de uma Google Agenda à minha conta Papo? As regras de conexão de múltiplas agendas podem variar conforme o seu plano e as configurações da sua conta. Para detalhes específicos sobre como gerenciar calendários de múltiplos profissionais, consulte as configurações da sua conta ou a documentação oficial no site. A IA da Papo realmente agenda sozinha no meu calendário? Sim. Após a configuração e a integração com a Google Agenda, a Inteligência Artificial da Papo pode gerenciar todo o fluxo de agendamento: entender o pedido do cliente no chat, verificar a disponibilidade em tempo real, propor horários e, com a confirmação, criar o evento na sua Google Agenda sem necessidade de intervenção humana. Preciso do módulo de Atendimentos para usar a integração? Sim, a integração com a Google Agenda é uma funcionalidade central do módulo de Atendimentos da Papo. É neste módulo que você cadastra seus serviços, define a duração e os profissionais responsáveis, informações que a IA utiliza para fazer o agendamento correto. Como o Papo sabe a duração de cada serviço para bloquear a agenda? A duração de cada serviço é definida por você ao cadastrá-lo no módulo de Atendimentos. Quando um cliente agenda um "Corte de Cabelo" de 1 hora, por exemplo, o sistema automaticamente bloqueia um período de 1 hora na agenda do profissional correspondente. Leia também - Como usar o módulo de Atendimentos para agendar serviços e horários Comece a usar gratuitamente → O primeiro usuário é gratuito e permite que você teste as principais funcionalidades da plataforma.

Como Gerenciar Documentos na Central de Arquivos da Papo

A Central de Arquivos da Papo (https://papo.global/) é o repositório centralizado onde você pode fazer o upload, organizar em pastas e gerenciar todos os documentos importantes da sua empresa. Essa funcionalidade garante que seus arquivos, como contratos, manuais e planilhas, estejam sempre acessíveis e prontos para serem usados em toda a plataforma, principalmente para alimentar a base de conhecimento dos seus assistentes de inteligência artificial. A gestão de documentos é fundamental para manter a organização e a eficiência de qualquer operação. Com a Central de Arquivos, você elimina a necessidade de procurar arquivos em conversas de WhatsApp, e-mails ou drives locais, concentrando tudo em um único local seguro e integrado ao seu ambiente de atendimento e CRM. | Funcionalidade | Descrição | | :--- | :--- | | Upload de Arquivos | Envie documentos, planilhas, imagens, PDFs e outros formatos de arquivo diretamente para a sua conta Papo. | | Organização em Pastas | Crie uma estrutura de pastas e subpastas para categorizar os arquivos por departamento, tipo de documento ou projeto. | | Busca Centralizada | Encontre arquivos rapidamente usando a busca por nome, pasta ou contexto de uso dentro da plataforma. | | Integração com IA | Use os documentos como fonte de conhecimento para treinar assistentes de IA, como o Capitão, para responder perguntas de forma automática. | | Acesso Unificado | Disponibilize os arquivos para toda a equipe, garantindo que todos usem sempre as versões mais atualizadas de propostas, catálogos e manuais. | Como funciona a Central de Arquivos A Central de Arquivos funciona como um drive de nuvem corporativo, mas totalmente integrado aos módulos da Papo. Em vez de ser apenas um local de armazenamento, ela conecta seus documentos às ferramentas que sua equipe usa no dia a dia. Por exemplo, um manual de produto em PDF que está na Central de Arquivos pode ser vinculado ao assistente de IA Capitão. Quando um cliente fizer uma pergunta sobre o produto no chat, a IA poderá consultar o documento para fornecer uma resposta precisa e instantânea, sem a necessidade de intervenção humana. Da mesma forma, uma proposta comercial padronizada pode ser armazenada e facilmente anexada em uma conversa com um lead, agilizando o processo de vendas e garantindo consistência na comunicação. Passo a passo para gerenciar seus arquivos Embora a interface exata possa variar, o processo para gerenciar seus documentos na Papo segue uma lógica simples e intuitiva. 1. Acesse a Central de Arquivos: Normalmente, você encontrará o acesso à Central de Arquivos no menu principal da plataforma ou dentro das configurações da sua conta, em uma área dedicada à gestão de recursos. 2. Faça o Upload de Arquivos: Dentro da Central, procure pela opção de "Upload" ou "Enviar Arquivo". Você poderá selecionar um ou mais arquivos do seu computador para adicionar à plataforma. É possível enviá-los para a pasta raiz ou diretamente para uma pasta específica que você já tenha criado. 3. Crie e Organize Pastas: Para manter tudo organizado, crie uma estrutura de pastas que faça sentido para sua operação. Por exemplo: "Contratos", "Propostas Comerciais", "Manuais de Treinamento" e "Material de Marketing". A plataforma permite visualizar as pastas e a quantidade de arquivos dentro de cada uma, facilitando a navegação. 4. Busque e Utilize os Arquivos: Use a barra de pesquisa para localizar um documento pelo nome ou pela pasta onde ele está guardado. Ao encontrar o arquivo, você pode visualizá-lo, obter seu link ou associá-lo a outras funcionalidades, como a base de conhecimento de um assistente de IA. Potencializando a IA com seus documentos A principal vantagem da Central de Arquivos é sua integração nativa com os assistentes de IA da Papo, como o Capitão. Ao usar seus próprios documentos como fonte de conhecimento, você garante que a IA responda com informações precisas e alinhadas à sua empresa. O processo é direto: 1. Faça o upload de documentos relevantes (FAQs, manuais, políticas, etc.) para a Central de Arquivos. 2. Acesse as configurações do seu assistente Capitão. 3. Vincule os documentos desejados à base de conhecimento do assistente. A partir desse momento, a IA estará apta a consultar o conteúdo desses arquivos para responder perguntas de clientes e até mesmo para auxiliar seus agentes durante o atendimento, sugerindo respostas baseadas na documentação oficial. Perguntas Frequentes (FAQ) Que tipos de arquivos posso enviar para a Central de Arquivos? Você pode enviar os formatos de arquivo mais comuns usados em ambientes de escritório, como PDF, DOCX, XLSX, TXT, JPG, e PNG. Para informações sobre limites de tamanho ou tipos de arquivo específicos, consulte a documentação na própria plataforma. Como os arquivos são usados pela inteligência artificial? Os documentos que você escolhe vincular a um assistente de IA, como o Capitão, tornam-se parte de sua base de conhecimento. A IA analisa o conteúdo desses arquivos para formular respostas precisas a perguntas de clientes e agentes, automatizando o suporte com base em suas fontes oficiais. É possível organizar os arquivos em pastas? Sim. A Central de Arquivos foi projetada para permitir a criação de uma estrutura hierárquica de pastas, assim como você faria em seu computador. Isso ajuda a manter os documentos categorizados e fáceis de encontrar. Como faço para encontrar um arquivo específico? A plataforma oferece uma funcionalidade de busca que permite pesquisar arquivos por nome, pela pasta em que estão localizados ou pelo contexto em que são utilizados, como por exemplo, quais arquivos estão associados a um determinado assistente de IA. Meus arquivos ficam seguros na plataforma? Sim. A Papo Global é uma plataforma SaaS profissional que opera com infraestrutura segura para proteger os dados e documentos dos clientes. Seus arquivos são armazenados de forma segura e acessíveis apenas por usuários autorizados da sua conta. Leia também - Alimentando a IA: Como Criar uma Base de Conhecimento para Respostas Automáticas - Visão geral do painel do Papo Global: menu lateral e módulos Comece grátis e organize seus documentos → O primeiro usuário é grátis e permite centralizar seus arquivos e conversas em um só lugar.

Como Integrar a Wavoip para Fazer e Receber Ligações na Papo

Para integrar a Wavoip e começar a fazer e receber ligações diretamente pela plataforma Papo (https://papo.global/), você deve criar uma nova caixa de entrada, selecionar o canal de voz correspondente à Wavoip e configurá-lo com seu token de API. Essa integração permite centralizar as chamadas de voz no mesmo painel onde você gerencia WhatsApp e outros canais, unificando o histórico de atendimento do cliente. A integração da sua conta de telefonia Wavoip com a Papo transforma a maneira como sua equipe lida com chamadas de voz. Em vez de usar um telefone físico ou um softphone separado, os agentes podem fazer e receber ligações diretamente da interface da Papo, onde já têm todo o contexto do cliente, incluindo conversas anteriores por chat e e-mail. Resumo da Integração O processo de conexão é feito em poucos passos e requer acesso de administrador tanto na sua conta Papo quanto na sua conta Wavoip. | Passo | Ação | |---|---| | 1. Obter Token | Acesse sua conta Wavoip e copie o token de API necessário para a integração. | | 2. Criar Caixa de Entrada | Na Papo, vá para Configurações → Caixas de Entrada e clique em "Adicionar caixa". | | 3. Selecionar Canal | Escolha o canal de voz e selecione "Wavoip" como provedor. | | 4. Configurar | Dê um nome à caixa (ex: "Vendas - Voz"), cole o token da Wavoip e salve. | | 5. Adicionar Agentes | Atribua os agentes ou times que poderão usar esta caixa para fazer e receber ligações. | Passo a Passo para Integrar sua Conta Wavoip Siga as etapas abaixo para conectar seu serviço de telefonia Wavoip à sua caixa de entrada da Papo. 1. Obtenha seu Token de API na Wavoip Antes de iniciar a configuração na Papo, você precisa do seu token de autenticação da Wavoip. 1. Acesse o painel de administração da sua conta Wavoip. 2. Navegue até a seção de API ou integrações para encontrar seu token. 3. Copie o token. Ele será usado no próximo passo. Se tiver dificuldades para encontrar o token, consulte a documentação de ajuda da Wavoip ou entre em contato com o suporte deles. 2. Crie a Caixa de Entrada na Papo Com o token em mãos, o próximo passo é criar o canal de comunicação dentro da Papo. 1. Acesse sua conta Papo e vá para Configurações no menu lateral. 2. Clique em Caixas de Entrada. 3. Pressione o botão Adicionar caixa de entrada. 4. Na lista de canais disponíveis, selecione a opção de Voz e, em seguida, escolha Wavoip como o provedor. 5. Preencha o formulário de configuração: - Nome da Caixa de Entrada: Dê um nome que ajude a identificar o canal, como "Suporte por Voz" ou "Comercial - Ligações". - Token da Wavoip: Cole o token que você copiou no passo anterior. 6. Clique em Criar Caixa de Entrada para salvar. 3. Atribua Agentes à Caixa de Entrada Para que sua equipe possa atender e realizar chamadas, você precisa associar os agentes à nova caixa de entrada. 1. Após criar a caixa, você será direcionado para a aba de Agentes. 2. Selecione os agentes ou times que terão permissão para usar este canal de voz. 3. Salve as alterações. A partir deste momento, a integração está ativa. As chamadas recebidas no seu número Wavoip serão direcionadas para os agentes selecionados dentro da Papo. Como Funciona na Prática Com a integração ativa, a gestão de chamadas fica totalmente centralizada. - Recebendo Ligações: Quando um cliente ligar para o seu número Wavoip, uma notificação em tempo real aparecerá na tela dos agentes atribuídos àquela caixa de entrada. O agente pode aceitar a chamada com um clique e conversar usando o microfone e o áudio do seu computador. - Fazendo Ligações: Para iniciar uma chamada, o agente pode navegar até o perfil de um contato no CRM da Papo e clicar no ícone de telefone ao lado do número do cliente. A ligação será iniciada através da Wavoip, mas a interface de controle permanecerá dentro da Papo. - Histórico Unificado: Todas as chamadas, tanto recebidas quanto realizadas, são registradas no histórico do contato. Isso permite que qualquer agente, ao atender o mesmo cliente no futuro, veja o registro das ligações junto com as conversas de WhatsApp, e-mails e anotações internas. Perguntas Frequentes Preciso ter uma conta Wavoip ativa para fazer a integração? Sim, a integração conecta sua conta Wavoip existente à Papo. Você precisa ter um plano ativo com a Wavoip para obter o token de API e para que o serviço de telefonia funcione. Onde encontro o token de API da Wavoip? O token de API é fornecido pela Wavoip em seu painel de administração. Geralmente, ele se encontra em uma seção chamada "API", "Integrações" ou "Credenciais". Para a localização exata, consulte a documentação da Wavoip. As ligações feitas e recebidas pela Papo ficam gravadas? A Papo registra o histórico de todas as chamadas, incluindo data, hora, duração e o agente envolvido. A gravação do áudio da chamada depende das configurações e do plano que você possui com a Wavoip. Verifique as funcionalidades do seu provedor de voz. Como um agente sabe que está recebendo uma ligação? O agente recebe uma notificação sonora e visual em tempo real na interface da Papo, permitindo que ele atenda a chamada diretamente no painel sem precisar de outro aplicativo. Posso direcionar ligações para equipes específicas? Sim. Ao configurar a caixa de entrada da Wavoip, você pode atribuí-la a um time específico criado na Papo. Dessa forma, apenas os agentes que fazem parte daquele time receberão as notificações de chamadas daquela caixa. A integração tem algum custo extra na Papo? A funcionalidade de integração com provedores de voz faz parte da plataforma Papo. Os custos associados ao uso do serviço de telefonia, como tarifas por minuto e aluguel de números, são cobrados diretamente pela Wavoip, de acordo com o plano que você contratou com eles. Leia também: - Como Analisar o Histórico e as Estatísticas de Ligações na Papo - Como criar times e distribuir o atendimento no Papo Global Comece grátis na Papo → O primeiro usuário é grátis e o cadastro não pede cartão de crédito.

O que é a API da Papo e para que serve?

A API da Papo (https://papo.global/) é uma interface de programação que permite que desenvolvedores conectem outros sistemas, como CRMs, ERPs ou plataformas de automação (como n8n), diretamente à sua conta Papo. Ela serve para automatizar ações, como enviar mensagens de WhatsApp, consultar contatos do Extrator ou acionar a inteligência artificial da plataforma, sem precisar usar a interface gráfica. A API abre um leque de possibilidades para personalizar e escalar sua operação, integrando as funcionalidades da Papo aos fluxos de trabalho já existentes na sua empresa. Em vez de realizar ações manualmente no painel, seu próprio software pode comandar a Papo para executar tarefas. API, Webhooks e Integrações Prontas: Qual a diferença? É comum confundir esses três conceitos. A tabela abaixo resume a principal diferença entre eles e quando usar cada um. | Característica | API (Interface de Programação) | Webhooks | Integrações Prontas | | :--- | :--- | :--- | :--- | | Direção | Seu sistema pede ou envia dados para a Papo. | A Papo envia dados para seu sistema. | A Papo se conecta a outro serviço. | | Iniciativa da Ação | Seu sistema externo. | A plataforma Papo. | O usuário, ao configurar no painel. | | Conhecimento Técnico | Requer programação ou uso de ferramentas como n8n. | Requer um endpoint (URL) no seu sistema para receber os dados. | Não requer programação, apenas configuração no painel. | | Exemplo de Uso | Enviar uma mensagem de WhatsApp quando uma compra é aprovada no seu e-commerce. | Notificar seu sistema de faturamento sempre que um novo contato é criado na Papo. | Conectar sua conta do Google Agenda para que a IA da Papo possa marcar reuniões. | Para que serve a API da Papo? Com a API, você pode construir automações e integrações sob medida para o seu negócio. Algumas das principais aplicações incluem: - Enviar Mensagens: Inicie conversas ou envie notificações de WhatsApp a partir do seu próprio sistema (ex: confirmação de pedido, lembrete de pagamento). - Acessar Contatos do Extrator: Consulte a lista de leads gerados pelo Extrator da Papo e importe-os para seu CRM ou ferramenta de marketing. - Gerenciar Instâncias: Verifique o status das suas conexões de WhatsApp diretamente do seu backend. - Utilizar a Inteligência Artificial: Envie um texto para a API de IA e receba uma resposta gerada com base no prompt configurado na sua conta Papo, permitindo usar a mesma inteligência em outros contextos. - Sincronizar Dados: Mantenha seus contatos, empresas e negócios sincronizados entre a Papo e seu CRM principal. - Criar Dashboards Personalizados: Extraia dados de atendimento e performance para alimentar painéis de Business Intelligence (BI) com métricas específicas da sua operação. Como começar a usar a API Para utilizar a API, é necessário ter conhecimento técnico ou usar uma ferramenta de automação visual que suporte chamadas de API REST, como o n8n. O processo geral é simples: | Passo | Ação | Detalhes | | :--- | :--- | :--- | | 1. Gerar Chaves de API | Acesse o painel da Papo e vá para a seção de desenvolvedores para criar suas chaves. | Você terá uma chave pública (pk_live_...) para identificar sua conta e uma chave secreta (sk_live_...) para autenticação. A chave secreta é exibida apenas uma vez. | | 2. Consultar a Documentação | Visite a documentação oficial da API para ver todos os endpoints disponíveis. | A documentação detalha as URLs, os parâmetros necessários e os formatos de resposta para cada ação (enviar mensagem, listar contatos, etc.). | | 3. Implementar as Chamadas | Escreva o código no seu sistema ou configure os blocos na sua ferramenta de automação. | As chamadas são feitas via HTTPS para a URL base https://app.papo.global/api/v1, enviando a chave secreta no cabeçalho de autorização. | | 4. Testar a Integração | Realize testes para garantir que seu sistema está se comunicando corretamente com a Papo. | Verifique se as mensagens são enviadas e se os dados são recebidos conforme o esperado. | Perguntas Frequentes Preciso ser programador para usar a API? Sim, o uso direto da API exige conhecimento em programação. No entanto, ferramentas de automação como o n8n ou Make permitem que você se conecte à API através de uma interface visual, sem precisar escrever código, apenas configurando os blocos de ação e inserindo suas chaves. Onde encontro minhas chaves de API? As chaves de API podem ser geradas no painel de configurações da sua conta Papo, em uma seção dedicada a desenvolvedores. Lembre-se que a chave secreta (secret key) é mostrada apenas no momento da sua criação. Guarde-a em um local seguro, pois ela não poderá ser recuperada. Se perdida, você precisará revogá-la e criar uma nova. O que exatamente eu posso fazer com a API? Você pode executar diversas ações que faria manualmente na plataforma. A documentação oficial lista todos os endpoints, mas os principais são: enviar mensagens de texto via WhatsApp (/messages), listar contatos extraídos (/contacts), listar suas conexões de WhatsApp (/instances) e usar o motor de IA da Papo para gerar textos (/ai/v1/complete). Usar a API tem algum custo adicional? O acesso à API em si não gera custos adicionais em seu plano. No entanto, as ações que você executa através dela podem consumir recursos que são tarifados, como o envio de mensagens via API do WhatsApp ou a extração de novos leads com o Extrator. Para detalhes sobre os custos operacionais, consulte a página de preços no site da Papo. A API da Papo é do tipo REST ou SOAP? A API da Papo é uma API REST moderna. Ela utiliza os métodos HTTP padrão (GET, POST, etc.) e se comunica usando o formato JSON, que é leve e fácil de ser interpretado pela maioria das linguagens de programação e ferramentas de automação. Qual a diferença entre usar a API diretamente e usar uma integração pronta como a do Google Agenda? A API oferece flexibilidade total para que você crie qualquer tipo de integração. Já as integrações prontas, como a do Google Agenda ou Wavoip, são soluções pré-construídas pela Papo para casos de uso comuns. Elas são ativadas com poucos cliques, sem necessidade de código, mas são limitadas às funcionalidades que foram previamente desenvolvidas. Leia também - Como Integrar a Wavoip para Fazer e Receber Ligações na Papo - Criando seu primeiro Flow de Automação do zero Comece grátis e explore as possibilidades → Conecte seus canais, configure a IA e comece a atender no mesmo dia.

Como Gerenciar sua Assinatura, Faturas e Créditos na Papo

Para gerenciar sua assinatura, faturas e créditos na Papo (https://papo.global), acesse a seção de pagamentos dentro das configurações da sua conta. Lá, você encontrará um link para o portal de pagamentos, onde é possível visualizar seu plano atual, baixar faturas anteriores, atualizar seu método de pagamento e adicionar créditos para serviços de uso avulso, como campanhas de WhatsApp. Manter o controle sobre a parte administrativa da sua conta é fundamental para garantir que sua operação de atendimento e vendas funcione sem interrupções. A Papo centraliza a gestão financeira em um portal de pagamentos seguro, permitindo que você administre sua assinatura e seus créditos de forma autônoma e transparente. Resumo da Gestão Financeira na Papo A tabela abaixo resume as principais ações de gerenciamento de conta e onde realizá-las. | Ação | Onde Realizar | Descrição | | --- | --- | --- | | Visualizar Plano Atual | Na seção de pagamentos do painel Papo e no portal de pagamentos. | Verifique os detalhes da sua assinatura, como o número de agentes incluídos e o valor da recorrência. | | Baixar Faturas | No portal de pagamentos. | Acesse o histórico de cobranças e faça o download das faturas (invoices) para seu controle financeiro. | | Alterar Método de Pagamento | No portal de pagamentos. | Atualize os dados do seu cartão de crédito ou outra forma de pagamento cadastrada. | | Adicionar Créditos | Na seção de pagamentos do painel Papo. | Recarregue seu saldo de créditos para usar em funcionalidades específicas, como disparos em massa. | Como acessar seu portal de pagamentos O portal de pagamentos é uma área segura, fornecida por nosso parceiro de processamento de pagamentos (Stripe), onde você pode gerenciar todos os aspectos da sua assinatura. Siga os passos para acessá-lo: 1. Faça login na sua conta Papo Global. 2. Navegue até a área de Configurações da sua conta. 3. Procure pela opção relacionada a Pagamentos, Assinatura ou Faturamento. 4. Dentro desta seção, você encontrará um resumo do seu plano atual e um botão ou link para "Gerenciar Assinatura" ou "Acessar Portal de Pagamentos". 5. Ao clicar, você será redirecionado de forma segura para o portal, onde poderá realizar as ações necessárias. Gerenciando sua assinatura e planos Dentro da seção de pagamentos no painel da Papo, você pode ver um resumo claro do seu plano atual. Isso inclui o nome do plano, o valor, a data da próxima renovação e o número de usuários (agentes) contratados. Se você precisar de mais agentes ou funcionalidades, a plataforma exibirá os planos de cobrança disponíveis para um upgrade. A alteração do plano é feita diretamente pelo portal de pagamentos, garantindo que a transição seja simples e segura. Lembre-se que o primeiro usuário na Papo é gratuito e não exige cartão de crédito, mas a adição de novos membros à equipe ativa a cobrança de um plano pago. Como baixar suas faturas Manter um registro de suas despesas é essencial para a contabilidade da sua empresa. O portal de pagamentos armazena todo o seu histórico de cobranças. Para baixar uma fatura: 1. Acesse o portal de pagamentos conforme as instruções acima. 2. Procure pela seção "Histórico de Faturamento" ou "Invoices". 3. Você verá uma lista de todas as cobranças passadas, com data e valor. 4. Clique na fatura desejada para visualizá-la em detalhes ou para fazer o download do documento em formato PDF. Adicionando e utilizando créditos Além da sua assinatura mensal ou anual, que cobre o acesso à plataforma e um número definido de agentes, algumas funcionalidades operam com base em créditos pré-pagos. Um exemplo comum é o uso do módulo Disparador para enviar campanhas de mensagens em massa pelo WhatsApp. Como funciona: - Assinatura: Garante o acesso contínuo à plataforma para sua equipe. - Créditos: São um saldo que você compra separadamente e que é consumido conforme você utiliza serviços específicos. Para adicionar créditos: 1. Acesse a seção de Pagamentos no seu painel Papo. 2. Procure pela opção "Adicionar Créditos" ou "Recarregar Saldo". 3. Você será direcionado para uma página de checkout, onde poderá escolher o valor da recarga e efetuar o pagamento. 4. O saldo de créditos será atualizado na sua conta e ficará visível no painel. Essa separação garante que você pague apenas pelo que usar em serviços de volume, mantendo o custo da sua assinatura previsível. Perguntas Frequentes Como posso alterar meu plano? Para alterar seu plano, acesse a seção de pagamentos no painel da Papo. Lá, você poderá ver os planos disponíveis e será direcionado ao portal de pagamentos para confirmar a alteração. A mudança geralmente é imediata, e o faturamento será ajustado no próximo ciclo de cobrança. Qual a diferença entre a assinatura e os créditos? A assinatura é um pagamento recorrente (mensal ou anual) que dá direito ao uso da plataforma Papo, incluindo um número específico de agentes e acesso aos módulos principais. Os créditos são um saldo pré-pago usado para funcionalidades de consumo, como o envio de campanhas de WhatsApp em massa, ligações ou uso avançado de APIs. Onde encontro o histórico de pagamentos e minhas faturas? Todo o seu histórico de pagamentos e as faturas para download estão disponíveis no portal de pagamentos. Para acessá-lo, vá até a seção de faturamento no painel da Papo e clique no link de gerenciamento da sua assinatura. Quais métodos de pagamento são aceitos? Os métodos de pagamento aceitos, como cartão de crédito e outras opções, são exibidos diretamente no portal de pagamentos no momento da contratação ou atualização do seu plano. O que acontece se meu pagamento da assinatura falhar? Se ocorrer uma falha no pagamento, você geralmente receberá uma notificação por e-mail. É importante atualizar seu método de pagamento no portal o mais rápido possível para evitar a interrupção do serviço. O acesso à plataforma pode ser suspenso após um período de inadimplência. Leia também - Quanto custa o Papo Global? Planos, preços e plano grátis - Como adicionar agentes (atendentes) à sua conta no Papo Global Comece grátis na Papo → O primeiro usuário é grátis e o cadastro não exige cartão de crédito.

Como gerar e usar chaves de API para integrar com outros sistemas

Para integrar sua conta com sistemas externos como CRMs, ERPs ou plataformas de automação (n8n, Zapier), a Papo (https://papo.global/) oferece chaves de API (Application Programming Interface) que podem ser geradas e gerenciadas diretamente no seu painel. Essas chaves funcionam como credenciais seguras que autorizam outros softwares a acessar e executar ações na sua conta Papo de forma programática. A API da Papo permite que você construa ecossistemas de trabalho conectados, automatizando tarefas que vão desde o envio de mensagens de WhatsApp até a extração de leads qualificados. Para garantir a segurança, a Papo utiliza um sistema de duas chaves: uma pública, para identificação, e uma secreta, para autenticação. | Tipo de Chave | Descrição | Nível de Segurança | Exemplo de Uso | | :--- | :--- | :--- | :--- | | Chave Pública (pk_live_...) | Um identificador único e fixo para a sua conta Papo. | Baixo. Pode ser exposta publicamente. | Identificar sua conta em um script no frontend do seu site. | | Chave Secreta (sk_live_...) | Uma "senha" para a API. Autentica suas requisições e concede permissão para agir em nome da sua conta. | Alto. Deve ser mantida em sigilo absoluto. | Autenticar uma chamada de API a partir do seu servidor (backend) para enviar uma mensagem. | Como gerar e encontrar suas chaves de API As chaves de API são gerenciadas em uma área específica da sua conta Papo. Siga os passos abaixo para acessá-las. 1. Acesse seu painel Papo e navegue até Configurações. 2. No menu de configurações, procure pela seção de Desenvolvedores ou API. 3. Nesta página, você encontrará sua Chave Pública (pk_live_...), que é fixa e pode ser copiada a qualquer momento. 4. Para a Chave Secreta, você precisará gerar uma nova. Clique no botão para criar uma nova chave. 5. Dê um nome descritivo para a chave, indicando onde ela será usada (ex: "Integração CRM", "Automação N8N"). Isso ajuda a identificar e revogar chaves específicas caso seja necessário. 6. Após a criação, a Chave Secreta (sk_live_...) será exibida uma única vez. Copie-a e guarde-a em um local seguro, como um gerenciador de senhas ou uma variável de ambiente no seu servidor. Por razões de segurança, a Papo não armazena o valor original da chave e não poderá exibi-la novamente. Se você perder uma chave secreta ou suspeitar que ela vazou, revogue-a imediatamente no painel e crie uma nova. Como usar as chaves para autenticar na API Toda comunicação com a API da Papo que envolve ações ou acesso a dados privados deve ser autenticada. Isso é feito enviando a chave secreta em um cabeçalho HTTP. A URL base para todas as chamadas de API é: https://app.papo.global/api/v1 Para se autenticar, inclua sua chave secreta no cabeçalho Authorization da sua requisição, precedida pela palavra Bearer. Exemplo de requisição com curl para obter dados da sua conta: curl https://app.papo.global/api/v1/me \ -H "Authorization: Bearer sk_live_SUA_CHAVE_SECRETA_AQUI" Neste exemplo: - sk_live_SUA_CHAVE_SECRETA_AQUI deve ser substituída pela sua chave secreta real. - O endpoint /me retorna informações sobre a conta autenticada, servindo como um bom teste para verificar se a sua chave está funcionando. A chave pública (pk_live_...) pode ser enviada opcionalmente no cabeçalho X-Papo-Public-Key como uma verificação adicional, mas a autenticação principal é sempre feita pela chave secreta. O que você pode fazer com a API da Papo? A API abre um leque de possibilidades para automatizar e integrar suas operações. Aqui estão alguns exemplos do que você pode fazer: - Enviar mensagens de WhatsApp: Crie scripts para enviar notificações, alertas ou mensagens transacionais através de um dos seus números conectados. - Buscar contatos do Extrator: Acesse a lista de leads que você extraiu com o Extrator de CNPJ para sincronizá-los com seu CRM principal. - Gerenciar instâncias: Liste e verifique o status das suas conexões de WhatsApp. - Utilizar a Inteligência Artificial: Envie textos para o motor de IA da Papo e receba respostas geradas com base nos seus prompts configurados. - Sincronizar dados: Mantenha seus sistemas internos (ERP, BI) atualizados com os dados gerados na Papo. Perguntas Frequentes (FAQ) ### Onde encontro a documentação completa da API? A documentação técnica detalhada, com todos os endpoints, parâmetros e exemplos de código em diferentes linguagens (JavaScript, Python), está disponível publicamente em papo.global/pt/docs. ### Minha chave secreta vazou. O que eu faço? Se você suspeita que sua chave secreta foi comprometida, acesse imediatamente a área de desenvolvedores no seu painel Papo, encontre a chave vazada na lista e clique para revogá-la. Uma vez revogada, ela não poderá mais ser usada para autenticar requisições. Em seguida, gere uma nova chave para substituir a antiga em suas integrações. ### Quantas chaves secretas posso criar? Você pode criar múltiplas chaves secretas. É uma boa prática de segurança gerar uma chave diferente para cada sistema ou ambiente que você integra (ex: uma para seu CRM, outra para seu sistema de automação, uma para o ambiente de testes, etc.). Isso permite revogar o acesso de um sistema específico sem afetar os outros. ### Posso usar a chave pública no frontend do meu site? Sim, a chave pública (pk_live_...) foi projetada para ser segura para uso em ambientes públicos, como o código JavaScript do seu site. Sua função é apenas identificar sua conta, não autenticar ações. A chave secreta, por outro lado, nunca deve ser exposta no código do lado do cliente. ### Qual a diferença entre a API da Papo e um Webhook? A principal diferença está em quem inicia a comunicação. Com a API, seu sistema inicia a ação: você "pede" (pull) dados da Papo ou "manda" (push) a Papo fazer algo, como enviar uma mensagem. Com um Webhook, a Papo inicia a ação: ela "empurra" (push) dados para o seu sistema automaticamente quando um evento específico acontece (ex: um contato chega a uma etapa de um Flow). ### Qual a diferença entre a API da Papo e a API Oficial do WhatsApp? A API Oficial do WhatsApp é focada exclusivamente nas funcionalidades do canal WhatsApp. A API da Papo é uma camada de abstração mais ampla e poderosa: ela permite que você controle não apenas o WhatsApp, mas também outros módulos da plataforma, como o CRM, o Extrator de Leads e o motor de Inteligência Artificial, tudo com um único conjunto de chaves e de forma simplificada. Leia também - Como usar a ação de Webhook nos Flows de Automação para integrar com outros sistemas - Posso usar o mesmo número do WhatsApp Business App na API Oficial da Papo? Comece a integrar gratuitamente → O primeiro usuário é grátis para você testar as automações e integrações no seu número.

Como conectar o Telegram para centralizar o atendimento

Para conectar o Telegram e centralizar o atendimento, você deve primeiro criar um bot no Telegram usando o BotFather para obter um token de API. Em seguida, na plataforma Papo (https://papo.global/), você deve adicionar uma nova caixa de entrada, selecionar o canal "Telegram", colar o token do seu bot e associar os agentes da sua equipe para começar a gerenciar todas as conversas em um painel unificado. Integrar o Telegram à Papo permite que sua equipe responda e gerencie interações de clientes diretamente na caixa de entrada omnichannel, junto com outros canais como WhatsApp, Instagram e E-mail. Isso elimina a necessidade de alternar entre aplicativos, garante um histórico unificado e possibilita o uso das ferramentas de automação e relatórios da Papo para otimizar seu atendimento no Telegram. A tabela abaixo resume o processo de conexão: | Passo | Ação | Detalhes | | :--- | :--- | :--- | | 1 | Criar um bot no Telegram | Use o @BotFather no Telegram para criar um novo bot e obter o token de acesso. | | 2 | Acessar Caixas de Entrada na Papo | No menu lateral, vá em Configurações → Caixas de Entrada. | | 3 | Adicionar uma Nova Caixa | Clique em Adicionar caixa de entrada e escolha o canal Telegram. | | 4 | Inserir o Token do Bot | Cole o token fornecido pelo BotFather no campo indicado. | | 5 | Configurar e Ativar | Dê um nome para a caixa de entrada e associe os agentes que farão o atendimento. | | 6 | Testar a Conexão | Envie uma mensagem para o seu bot no Telegram e verifique se ela chega na Papo. | Passo a passo para conectar seu bot do Telegram Siga as etapas detalhadas abaixo para configurar seu canal do Telegram na Papo. O processo é dividido em duas partes: criar o bot no Telegram e conectá-lo à Papo. Parte 1: Criando seu bot no Telegram com o BotFather Antes de conectar na Papo, você precisa ter um bot no Telegram. Se você já tem um, pode pular para a Parte 2. 1. Inicie uma conversa com o BotFather: Abra o aplicativo do Telegram, pesquise por @BotFather (procure pelo perfil verificado) e inicie uma conversa com ele. O BotFather é o bot oficial do Telegram para gerenciar todos os outros bots. 2. Crie um novo bot: Digite ou clique no comando /newbot. 3. Dê um nome ao seu bot: O BotFather solicitará um nome para o seu bot. Este é o nome que seus clientes verão. Exemplo: "Atendimento Loja XYZ". 4. Escolha um nome de usuário: Em seguida, escolha um nome de usuário para o bot. Ele deve ser único e terminar com a palavra "bot". Exemplo: AtendimentoLojaXYZ_bot. 5. Copie o token de acesso: Se o nome de usuário estiver disponível, o BotFather enviará uma mensagem de confirmação contendo o token de acesso (API token). Este token é uma sequência longa de caracteres e números. Copie-o e guarde-o em um local seguro, pois você precisará dele na próxima etapa. Parte 2: Configurando a caixa de entrada na Papo Com o token em mãos, o processo na Papo é simples e rápido. 1. Acesse as Configurações de Caixas de Entrada: Faça login no seu painel da Papo. No menu lateral esquerdo, clique no ícone de Configurações e, em seguida, selecione a opção Caixas de Entrada. 2. Adicione uma Nova Caixa de Entrada: Na tela de "Caixas de Entrada", clique no botão Adicionar caixa de entrada. Você verá uma lista com todos os canais que podem ser integrados à Papo. 3. Escolha o Canal Telegram: Selecione a opção Telegram da lista. 4. Cole o Token do Bot: No formulário de configuração, cole o token de acesso que você copiou do BotFather no campo "Bot Token". 5. Finalize a Configuração: - Nome da Caixa de Entrada: Dê um nome descritivo para fácil identificação (ex: "Suporte - Telegram" ou "Vendas Telegram"). - Adicionar Agentes: Associe os membros da sua equipe que serão responsáveis por atender as conversas que chegarem por este canal. Apenas os agentes adicionados aqui poderão visualizar e responder às mensagens desta caixa de entrada. 6. Crie a Caixa de Entrada: Clique em Criar Caixa de Entrada. A Papo configurará automaticamente a conexão (webhook) com o Telegram. Pronto! Sua nova caixa de entrada do Telegram aparecerá na lista de canais. Para testar, procure seu bot pelo nome de usuário no Telegram, envie uma mensagem e veja-a aparecer instantaneamente no seu painel da Papo. Perguntas Frequentes Preciso de conhecimento técnico para criar um bot no Telegram? Não. O processo de criação de um bot básico para atendimento é feito através de uma conversa com o @BotFather no Telegram, seguindo comandos simples. Você não precisa escrever nenhuma linha de código para obter o token necessário para a integração com a Papo. O que é um "token" do bot e por que ele é importante? O token é uma chave de autorização única, como uma senha, que permite que a plataforma Papo se comunique de forma segura com a API do Telegram em nome do seu bot. É fundamental que você mantenha seu token em segredo e não o compartilhe publicamente. Se você acredita que seu token foi comprometido, pode gerar um novo através do BotFather usando o comando /revoke. Posso conectar mais de um bot do Telegram na Papo? Sim, você pode conectar múltiplos bots do Telegram, cada um em sua própria caixa de entrada. Isso é útil para gerenciar diferentes departamentos ou marcas. A quantidade de caixas de entrada que você pode criar depende dos limites do seu plano na Papo. As mensagens antigas do Telegram aparecerão na Papo após a conexão? Não. A integração começará a sincronizar as novas mensagens que chegarem ao seu bot a partir do momento em que a conexão for estabelecida com sucesso. Conversas e mensagens anteriores não serão importadas para a plataforma Papo. O que fazer se as mensagens não estiverem chegando na Papo? Se as mensagens enviadas ao seu bot não aparecerem na sua caixa de entrada da Papo, verifique os seguintes pontos: 1. Token Correto: Confirme se o token colado na Papo é exatamente o mesmo fornecido pelo BotFather e se ele não foi revogado. 2. Agentes Associados: Verifique se pelo menos um agente (mesmo que seja você) foi adicionado à caixa de entrada do Telegram nas configurações da Papo. Sem agentes, as conversas não têm para onde ser direcionadas. 3. Status do Canal: Na seção "Caixas de Entrada" da Papo, verifique se o canal do Telegram aparece como ativo. Comece a usar grátis e centralize seu atendimento → O primeiro usuário é sempre grátis para você testar e organizar seus canais.

Como Salvar Leads da Papo no Google Sheets com Webhooks

Para salvar novos leads e negócios da Papo (https://papo.global/) diretamente em uma planilha do Google Sheets, você pode utilizar o módulo de automação Flows para configurar um gatilho que, ao ser acionado, envia os dados do contato através de uma ação de Webhook. Isso requer a criação de um endpoint (URL) no Google Sheets, seja através de uma plataforma de automação como Zapier ou Make.com, ou com um Google Apps Script, para receber as informações enviadas pela Papo em tempo real. Conectar a Papo ao Google Sheets permite que você crie um banco de dados de leads centralizado, atualizado automaticamente, sem a necessidade de exportar e importar planilhas manualmente. Essa integração é ideal para times de vendas, marketing e operações que precisam de visibilidade sobre os contatos gerados e seu progresso no funil. Visão Geral do Processo de Integração A automação funciona como uma ponte entre a Papo e o Google Sheets. Quando um evento específico ocorre na Papo (como a criação de um novo contato), o Flow é acionado e envia os dados para a URL que você configurou. | Etapa | Ferramenta | Ação | | :--- | :--- | :--- | | 1. Preparação | Google Sheets & Ferramenta Externa | Criar a planilha que receberá os dados e gerar uma URL de Webhook usando um serviço como Zapier/Make.com ou um Google Apps Script. | | 2. Gatilho (Trigger) | Papo | Um evento acontece na plataforma, como um novo contato ser criado, uma etiqueta ser adicionada ou um negócio ser movido no Kanban. | | 3. Automação | Papo (Flows) | O Flow de automação detecta o gatilho e inicia as ações configuradas. | | 4. Envio dos Dados | Papo (Ação de Webhook) | A ação de Webhook envia um pacote de dados (payload JSON) para a URL gerada na Etapa 1. | | 5. Recebimento e Registro| Google Sheets | A URL recebe os dados e a lógica configurada (no Zapier ou Apps Script) insere uma nova linha na planilha com as informações do lead. | Como Configurar a Integração Passo a Passo O processo é dividido em duas partes principais: primeiro, preparar o Google Sheets para receber os dados e, segundo, configurar a automação na Papo para enviá-los. Parte 1: Obter a URL do Webhook no Google Sheets A Papo precisa de um endereço (URL) para onde enviar as informações. Você não cria essa URL na Papo, mas sim na ferramenta que irá receber os dados. Existem duas abordagens principais: Opção A: Usar uma Plataforma de Automação (Recomendado para iniciantes) Ferramentas como Zapier, Make.com (antigo Integromat) ou n8n são as mais fáceis para conectar a Papo a centenas de outros aplicativos sem código. 1. Crie uma conta em uma dessas plataformas. 2. Inicie uma nova automação (um "Zap" no Zapier ou "Cenário" no Make). 3. Escolha "Webhooks" como o gatilho (trigger). Geralmente, a opção se chama "Catch Hook" ou "Custom Webhook". 4. Copie a URL do Webhook fornecida pela plataforma. Ela será única para sua automação. 5. Adicione uma ação na automação para "Adicionar uma Linha" (Add a Row) no Google Sheets. Conecte sua conta Google, selecione a planilha e as colunas onde os dados serão salvos. Deixe essa automação ativa e pronta para receber um teste. Opção B: Usar Google Apps Script (Avançado) Se você tem familiaridade com programação, pode criar seu próprio endpoint diretamente no Google Sheets. 1. Abra sua planilha do Google Sheets. 2. Vá em Extensões > Apps Script. 3. Cole um código com uma função doPost(e) que interpreta os dados recebidos e os adiciona à planilha. 4. Clique em Implantar > Nova implantação. 5. Selecione o tipo "App da Web". 6. Configure o acesso para "Qualquer pessoa" (mesmo anônimos), pois o webhook da Papo não fará login na sua conta Google. 7. Copie a URL do app da Web gerada. Essa é a sua URL de webhook. Parte 2: Configurar o Flow de Automação na Papo Com a URL do webhook em mãos, agora você pode configurar a Papo para enviar os dados. 1. No painel da Papo, acesse o módulo Flows. 2. Clique para criar um novo Flow. 3. Defina o Gatilho: Escolha o evento que iniciará a automação. Exemplos comuns são: - Contato Criado: Para salvar todo novo lead que entra na plataforma. - Etiqueta Adicionada: Quando um lead é qualificado e recebe uma etiqueta como "Lead Quente". - Negócio Criado: Quando um card é criado no seu funil do Kanban. 4. Adicione a Ação de Webhook: No editor do Flow, adicione um novo passo e selecione a ação "Webhook". 5. Configure a Ação: - URL: Cole a URL que você gerou na Parte 1 (seja do Zapier, Make ou do seu Apps Script). - Método: Mantenha como POST. - Corpo (Body): Aqui você define quais dados serão enviados. O formato é JSON. Você pode usar as variáveis da Papo para preencher os valores dinamicamente. Exemplo de corpo JSON: { "nome": "{{contact.name}}", "telefone": "{{contact.phone}}", "email": "{{contact.email}}", "etapa_funil": "{{deal.stage.name}}", "origem": "{{contact.channel.name}}" } 6. Ative o Flow: Salve e ative sua automação. A partir de agora, sempre que o gatilho for acionado na Papo, os dados do contato ou negócio serão enviados instantaneamente para sua planilha do Google Sheets. Perguntas Frequentes (FAQ) Preciso saber programar para fazer essa integração? Não necessariamente. Usando plataformas de automação como Zapier ou Make.com, você pode conectar a Papo ao Google Sheets através de uma interface visual, sem escrever nenhuma linha de código. A opção com Google Apps Script é recomendada apenas para usuários avançados. Que tipo de dados a Papo pode enviar via webhook? Você pode enviar praticamente qualquer dado associado ao contato, negócio ou mensagem, incluindo campos padrão (nome, telefone, e-mail), atributos personalizados que você tenha criado, informações do funil Kanban (nome do negócio, valor, etapa), etiquetas e detalhes da conversa. A integração funciona em tempo real? Sim. A ação de Webhook é executada instantaneamente assim que o gatilho do Flow é acionado na Papo. Isso significa que seus leads aparecerão na planilha segundos após serem criados ou atualizados na plataforma. Posso atualizar uma linha existente no Google Sheets em vez de criar uma nova? Sim, mas a lógica para isso precisa ser configurada na ferramenta que recebe o webhook (Zapier, Make.com ou seu script). Por exemplo, no Zapier, você pode adicionar uma etapa de "Lookup Spreadsheet Row" para procurar se o lead já existe (pelo telefone ou e-mail) e, em seguida, usar uma ação de "Update Spreadsheet Row" em vez de "Create Spreadsheet Row". Onde encontro a lista de variáveis que posso usar no corpo do webhook? Dentro do editor de Flows da Papo, ao configurar a ação de Webhook, a plataforma geralmente oferece uma lista de variáveis disponíveis ({{contact.name}}, {{deal.value}}, etc.) que você pode inserir no corpo JSON. Comece a automatizar seus leads gratuitamente → Crie sua conta na Papo para centralizar seus canais de atendimento e automatizar processos de vendas e marketing.

Como organizar sua Central de Ajuda com categorias e artigos?

Para organizar sua Central de Ajuda na Papo (https://papo.global/), você deve primeiro criar categorias para agrupar os tópicos e, em seguida, adicionar, editar e publicar os artigos dentro dessas categorias. O módulo Help Center da Papo permite estruturar sua base de conhecimento de forma hierárquica, facilitando a navegação para clientes e para sua equipe interna. Uma Central de Ajuda bem organizada é uma ferramenta poderosa para escalar o autoatendimento, reduzir o volume de chamados repetitivos e garantir que a informação correta esteja sempre acessível. Ao estruturar o conteúdo de maneira lógica, você melhora a experiência do usuário e otimiza o tempo da sua equipe de suporte, que pode se concentrar em questões mais complexas. A Estrutura da Central de Ajuda na Papo A organização do conteúdo no módulo Help Center da Papo segue uma hierarquia simples de três níveis. Entender essa estrutura é o primeiro passo para planejar sua base de conhecimento. | Componente | Descrição | Finalidade | | :--- | :--- | :--- | | Portal | O site principal que hospeda toda a sua Central de Ajuda. É possível ter múltiplos portais para diferentes públicos. | Servir como o ponto de acesso central para todo o seu conteúdo de ajuda (ex: ajuda.suaempresa.com). | | Categoria | As seções ou pastas que agrupam artigos por tema dentro de um portal. | Organizar o conteúdo de forma lógica para que os usuários encontrem facilmente o que procuram (ex: "Pagamentos", "Primeiros Passos"). | | Artigo | A página de conteúdo individual, contendo textos, tutoriais, imagens e respostas para dúvidas específicas. | Fornecer a informação detalhada que o usuário precisa para resolver um problema ou entender um processo. | Como Criar e Gerenciar Categorias As categorias são a espinha dorsal da sua Central de Ajuda. Uma boa categorização torna a navegação intuitiva e a localização de informações muito mais rápida. 1. Acesse o Módulo Help Center: No painel principal da Papo, navegue até o módulo "Help Center". 2. Selecione o Portal: Caso tenha mais de um portal, escolha aquele em que deseja criar a nova categoria. 3. Crie a Categoria: Procure pela opção de adicionar uma nova categoria. Dê a ela um nome claro e objetivo, pensando em como seus usuários buscariam por aquele assunto. 4. Planeje sua Estrutura: Antes de criar várias categorias, pense nos grandes temas do seu negócio. Boas categorias podem ser baseadas em: - Jornada do Cliente: Primeiros Passos, Configurações Avançadas, Solução de Problemas. - Áreas do Produto: Módulo de Vendas, Módulo de Suporte, Integrações. - Processos Internos: Políticas de RH, Scripts de Atendimento, Guias de Ferramentas. Manter os nomes das categorias curtos e diretos ajuda os usuários a identificar rapidamente o agrupamento de conteúdo relevante para sua dúvida. Como Criar e Gerenciar Artigos Com as categorias definidas, o próximo passo é popular o conhecimento. Os artigos são as páginas que contêm as respostas e os guias que seus usuários irão consumir. O ciclo de vida de um artigo na Papo é projetado para permitir colaboração e controle de qualidade antes da publicação. 1. Navegue até a Categoria Correta: Dentro do portal, selecione a categoria onde o novo artigo se encaixa. 2. Crie um Novo Artigo: Inicie a criação de um novo artigo. A plataforma oferece um editor de texto para você escrever e formatar seu conteúdo. 3. Escreva e Salve como Rascunho: A funcionalidade mais importante nesta etapa é salvar o artigo como rascunho (draft). Isso significa que o artigo fica salvo na plataforma, mas não está visível publicamente no seu portal. Use esse status para escrever com calma, pedir revisões de outros membros da equipe e garantir que a informação esteja precisa. 4. Edite e Formate: Use títulos, listas e negrito para quebrar grandes blocos de texto e facilitar a leitura. Uma boa formatação ajuda o leitor a escanear o conteúdo e encontrar a resposta mais rapidamente. 5. Publique o Artigo: Quando o artigo estiver finalizado e aprovado, basta alterar seu status de "rascunho" para "publicado" (published). A partir desse momento, ele estará disponível para todos que acessarem sua Central de Ajuda. 6. Atualize Conforme Necessário: Produtos e processos mudam. Você pode editar, despublicar (voltar para rascunho) ou excluir artigos a qualquer momento para manter sua base de conhecimento sempre atualizada. Perguntas Frequentes Como decido quais categorias criar? A melhor abordagem é pensar como seu cliente. Analise os tickets de suporte mais comuns, as perguntas mais frequentes feitas aos seus vendedores e a jornada natural de uso do seu produto ou serviço. Agrupe esses temas em categorias lógicas e intuitivas. Por exemplo, todas as dúvidas sobre cobrança podem ficar na categoria "Faturamento e Pagamentos". Qual a diferença entre salvar como rascunho e publicar? Um artigo salvo como rascunho (draft) só é visível para os usuários logados na sua conta Papo com permissão para acessar o Help Center. Ele não aparece no portal público. Um artigo publicado (published) fica visível para qualquer pessoa que acesse o portal da sua Central de Ajuda, seja um cliente ou um colaborador. Posso ter uma Central de Ajuda para clientes e outra para minha equipe? Sim. A Papo permite a criação de múltiplos portais. Isso é ideal para separar o conhecimento. Você pode ter um portal público para seus clientes (ajuda.suaempresa.com) e um portal privado, acessível apenas internamente, para treinar sua equipe e documentar processos internos. Os artigos da Central de Ajuda são usados pela IA da Papo? Sim. O conteúdo que você publica na sua Central de Ajuda pode ser configurado como uma fonte de conhecimento para a inteligência artificial da Papo. Isso permite que os chatbots e assistentes de IA respondam a perguntas de forma automática com base na sua documentação oficial, garantindo respostas precisas e consistentes. Como os usuários encontram os artigos no portal? Além de navegar pelas categorias, os usuários podem utilizar a funcionalidade de busca disponível no portal da Central de Ajuda. Eles podem digitar palavras-chave para encontrar rapidamente os artigos mais relevantes para sua dúvida, tornando o processo de autoatendimento ainda mais eficiente. Posso adicionar imagens ou vídeos aos meus artigos? Sim, o editor de artigos permite a inserção de mídias como imagens e vídeos para tornar os tutoriais mais visuais e fáceis de seguir. Para gerenciar esses arquivos, você pode utilizar a Central de Arquivos da Papo. Leia também - Visão Geral dos Relatórios: Onde encontrar cada métrica na Papo - O que são e como usar as Macros para agilizar ações repetitivas Comece a organizar sua base de conhecimento gratuitamente → O primeiro usuário da plataforma é gratuito, permitindo que você comece a construir sua Central de Ajuda hoje mesmo.

O que são as Conexões e como gerenciá-las?

As Conexões na Papo (https://papo.global/), também conhecidas como instâncias, são os links técnicos que integram seus canais de comunicação externos — como WhatsApp, Instagram e E-mail — à plataforma. Elas funcionam como a "ponte" que permite que as mensagens fluam para sua caixa de entrada unificada. Você pode gerenciar todas as suas conexões na seção "Caixas de Entrada", localizada no menu de "Configurações" da sua conta. Para que sua operação de atendimento funcione sem interrupções, é essencial que as conexões com seus canais estejam sempre ativas. A Papo centraliza a gestão dessas conexões, permitindo que você identifique e resolva problemas rapidamente, garantindo que nenhuma conversa com o cliente seja perdida. Qual a diferença entre Caixa de Entrada e Conexão? Embora os termos sejam usados de forma relacionada, eles representam conceitos diferentes na plataforma: - Conexão (ou Instância): É o vínculo técnico e de autenticação com a plataforma de origem (ex: a API da Meta para WhatsApp e Instagram, o servidor do seu e-mail, o bot do Telegram). É a "ponte" que busca e envia mensagens. - Caixa de Entrada: É a interface dentro da Papo onde sua equipe visualiza e responde às conversas que chegam através de uma Conexão. É o espaço de trabalho associado a um canal específico. Em resumo, cada Caixa de Entrada que você cria na Papo é alimentada por uma Conexão. O gerenciamento do status e da saúde dessa Conexão é feito através das configurações da Caixa de Entrada correspondente. Como visualizar e gerenciar suas Conexões Acessar o painel de gerenciamento de todas as suas conexões é um processo simples e centralizado. Apenas usuários com permissão de administrador podem acessar esta área. 1. Faça login no seu painel da Papo. 2. No menu lateral, clique no ícone de Configurações. 3. Dentro das configurações, selecione a opção Caixas de Entrada. Nesta tela, você encontrará uma lista de todas as Caixas de Entrada criadas na sua conta. Cada uma representa uma Conexão ativa com um canal e exibe um indicador de status, permitindo uma visão rápida da saúde de toda a sua operação de comunicação. Entendendo o status de cada Conexão Ao lado de cada Caixa de Entrada, um indicador visual mostra se a conexão com o canal de origem está funcionando corretamente. Saber o que cada status significa é crucial para agir rapidamente. | Status | Significado | Ação Recomendada | | :--- | :--- | :--- | | Ativo / Conectado | A Conexão está funcionando corretamente. Novas mensagens estão sendo recebidas em tempo real na sua Caixa de Entrada da Papo. | Nenhuma ação é necessária. Sua equipe pode continuar o atendimento normalmente. | | Inativo / Desconectado | A Conexão com a plataforma de origem foi perdida. Novas mensagens não chegarão à Papo até que o problema seja resolvido. | É necessário reconectar o canal. Clique nas configurações da Caixa de Entrada para iniciar o processo de reautenticação. | | Requer Atenção / Erro | Existe um problema de configuração ou autorização que impede o funcionamento da Conexão. Pode ser uma senha alterada, um token expirado ou permissões revogadas. | Verifique as credenciais e permissões na plataforma de origem (ex: Meta Business Suite). Siga as instruções na tela da Papo para corrigir o erro. | Causas comuns de desconexão e como solucionar Uma Conexão pode ser interrompida por diversos motivos, a maioria ligada a políticas de segurança ou atualizações nas plataformas de origem. Causas mais comuns: - WhatsApp (API Oficial Meta): A senha de um administrador da conta Meta Business foi alterada, ou as permissões concedidas à Papo foram revogadas manualmente no Gerenciador de Negócios da Meta. - Instagram e Facebook: A senha da conta do Facebook vinculada foi trocada. Por segurança, a Meta também exige que a autorização de aplicativos de terceiros seja renovada periodicamente. - E-mail (IMAP/SMTP): A senha da sua conta de e-mail foi alterada, ou as configurações do servidor do seu provedor (porta, SSL/TLS) mudaram. - Telegram: O "Bot Token" gerado pelo BotFather foi revogado ou um novo token foi criado, invalidando o anterior. Como reconectar um canal: Quando uma conexão falha, não é preciso criar uma nova Caixa de Entrada. Basta revalidar a existente. 1. Navegue até Configurações → Caixas de Entrada. 2. Localize a Caixa de Entrada com o status "Inativo" ou "Requer Atenção". 3. Clique no ícone de Configurações correspondente àquela caixa. 4. A plataforma exibirá um aviso claro e um botão para Reconectar ou Reautenticar. 5. Siga as instruções na tela. Geralmente, o processo envolve fazer login novamente na plataforma de origem (por exemplo, entrar com sua conta do Facebook) e conceder as permissões necessárias para que a Papo volte a gerenciar as mensagens. Após seguir os passos, o status da Conexão deve voltar para "Ativo" em poucos instantes. Perguntas Frequentes Onde eu gerencio minhas Conexões? Você gerencia o estado de suas Conexões na seção Caixas de Entrada, dentro do menu de Configurações. Lembre-se que apenas usuários com permissão de administrador têm acesso a esta área da plataforma. O que acontece com as mensagens se uma Conexão cair? Quando uma Conexão é interrompida, a Papo para de receber novas mensagens daquele canal. O histórico de conversas existentes permanece acessível, mas nenhuma nova interação será sincronizada até que a Conexão seja restabelecida. Por que minha Conexão do Instagram ou Facebook desconecta com frequência? Isso geralmente ocorre devido às políticas de segurança da Meta (empresa dona do Facebook e Instagram). A Meta pode invalidar sessões de login e autorizações de aplicativos de terceiros periodicamente para proteger a conta do usuário. Alterar a senha da sua conta do Facebook também causa uma desconexão imediata. Preciso criar uma nova Caixa de Entrada se a Conexão falhar? Não. Você não precisa criar uma nova Caixa de Entrada nem perder seu histórico. Basta seguir o processo de Reconexão ou Reautenticação nas configurações da Caixa de Entrada já existente para restaurar a Conexão. Como sei qual o provedor da minha Conexão? Na tela de Caixas de Entrada, a lista de conexões geralmente exibe o provedor associado a cada canal, como "WhatsApp (Meta)" ou "Telegram", ajudando a identificar a origem da conexão. Posso gerenciar as Conexões pela API? Sim, a API da Papo permite listar as instâncias (conexões) da sua conta para monitoramento externo. Para mais detalhes sobre os endpoints disponíveis, consulte a documentação oficial da API. Comece a usar grátis e centralize seus canais → Conecte seus canais de atendimento em um só lugar e comece a organizar sua operação.

Como alterar meu e-mail de login e redefinir minha senha na Papo?

Para alterar seu e-mail de login ou redefinir sua senha na Papo (https://papo.global/), você pode seguir dois processos distintos. A alteração do e-mail é feita diretamente nas configurações do seu perfil, dentro da plataforma, enquanto a redefinição de senha é iniciada na tela de login através da opção "Esqueci minha senha". Manter suas credenciais de acesso atualizadas é fundamental para a segurança da sua conta. Seja por uma mudança de endereço de e-mail ou simplesmente por esquecimento da senha, a Papo oferece caminhos simples para você gerenciar seus dados de acesso. A tabela abaixo resume as duas operações para que você possa identificar rapidamente qual processo precisa seguir. | Ação | Onde Realizar | Passos Principais | | :--- | :--- | :--- | | Alterar E-mail de Login | Dentro da plataforma (logado) | 1. Acesse Configurações → Perfil. 2. Edite o campo de e-mail. 3. Confirme a alteração (pode ser necessário verificar o novo e-mail). | | Redefinir Senha | Na tela de login (deslogado) | 1. Clique em "Esqueci minha senha". 2. Informe seu e-mail de login. 3. Siga o link enviado para sua caixa de entrada. | Como alterar seu e-mail de login Se você ainda tem acesso à sua conta e deseja apenas atualizar o e-mail que usa para fazer login, o processo é feito dentro das configurações do seu perfil. Lembre-se que este e-mail é o principal ponto de contato para notificações da plataforma e recuperação de acesso. Siga os passos abaixo: 1. Faça login na sua conta Papo: Acesse a plataforma com seu e-mail e senha atuais. 2. Acesse as Configurações: Navegue até o menu de Configurações, geralmente localizado no canto inferior esquerdo da tela. 3. Vá para seu Perfil: Dentro das configurações, procure e clique na opção "Perfil" ou "Minha Conta". 4. Localize e Edite o E-mail: Na página do seu perfil, você encontrará seus dados pessoais, incluindo seu nome e e-mail de login. Clique na opção para editar ou alterar o campo de e-mail. 5. Informe o Novo E-mail: Digite o novo endereço de e-mail que deseja usar para acessar a Papo. 6. Confirme a Alteração: Por segurança, pode ser solicitado que você confirme sua senha atual ou clique em um link de verificação enviado para o novo endereço de e-mail. Verifique sua caixa de entrada e spam. 7. Salve as Mudanças: Após a confirmação, salve as alterações. Na próxima vez que for acessar a plataforma, utilize o novo e-mail. Como redefinir sua senha Caso você tenha esquecido sua senha e não consiga acessar sua conta, o caminho é usar a função de recuperação na tela de login. Siga este passo a passo: 1. Acesse a Tela de Login: Abra seu navegador e vá para a página de login da Papo (chat.papo.global/app/login). 2. Clique em "Esqueci minha senha": Abaixo dos campos de e-mail e senha, você encontrará um link com o texto "Esqueci minha senha" ou similar. Clique nele. 3. Informe seu E-mail: Na nova tela, digite o endereço de e-mail associado à sua conta Papo e clique no botão para enviar as instruções de redefinição. 4. Verifique sua Caixa de Entrada: A Papo enviará um e-mail com um link exclusivo para redefinir sua senha. A mensagem pode levar alguns minutos para chegar. Não se esqueça de verificar a pasta de spam ou lixo eletrônico. 5. Crie uma Nova Senha: Clique no link recebido no e-mail. Você será redirecionado para uma página segura onde poderá criar e confirmar sua nova senha. Escolha uma senha forte, combinando letras, números e símbolos. 6. Faça Login: Volte para a tela de login e acesse sua conta usando seu e-mail e a nova senha que você acabou de criar. Perguntas Frequentes O que acontece se eu não tiver mais acesso ao meu e-mail antigo? Se você ainda consegue fazer login na Papo com sua senha, pode alterar o e-mail seguindo os passos na seção "Como alterar seu e-mail de login". Caso você não consiga fazer login (por ter esquecido a senha) e também não tenha mais acesso ao e-mail cadastrado para redefini-la, será necessário entrar em contato com o suporte da Papo para comprovar sua identidade e solicitar a alteração. Não recebi o e-mail de redefinição de senha. O que fazer? Primeiro, verifique sua pasta de spam ou lixo eletrônico. Em seguida, confirme se digitou o endereço de e-mail corretamente na tela de recuperação. Aguarde alguns minutos, pois pode haver um pequeno atraso no envio. Se, mesmo após essas verificações, o e-mail não chegar, tente o processo novamente. Se o problema persistir, entre em contato com o suporte. Posso usar o mesmo e-mail para duas contas diferentes na Papo? Geralmente, cada conta na plataforma Papo deve estar associada a um endereço de e-mail único. O e-mail funciona como um identificador exclusivo para cada usuário e sua respectiva área de trabalho (workspace). Tentar criar uma nova conta com um e-mail já existente normalmente resultará em um aviso de que o usuário já está cadastrado. Alterar meu e-mail de login afeta as integrações da minha conta? Não. Alterar o seu e-mail de login pessoal não afeta as configurações das caixas de entrada (como WhatsApp, Instagram, E-mail SMTP/IMAP, etc.), pois elas são vinculadas à conta da empresa, não ao seu perfil de usuário. No entanto, se você tiver alguma integração pessoal, como a conexão com sua agenda do Google Calendar, pode ser necessário reconectá-la ou reautenticá-la após a mudança. Com que frequência devo alterar minha senha? Como boa prática de segurança digital, é recomendável alterar suas senhas periodicamente, a cada 3 ou 6 meses. Além disso, você deve alterar sua senha imediatamente se suspeitar que sua conta foi comprometida ou se você usou a mesma senha em outro serviço que sofreu uma violação de dados. Comece a usar grátis e organize seu atendimento → Cadastre-se e valide o fluxo completo de atendimento com o primeiro usuário grátis.

Como gerenciar as permissões de acesso com Funções Personalizadas?

Na Papo (https://papo.global), as funções personalizadas permitem que administradores criem perfis de acesso detalhados, definindo exatamente o que um agente pode ver e fazer na plataforma. É possível controlar quais conversas ele acessa, se pode gerenciar contatos e relatórios, se tem permissão para apagar mensagens enviadas e quais módulos (como Kanban, Disparador, Flows e Radar) aparecem em seu menu. Um administrador cria a função em Configurações → Funções Personalizadas e depois a atribui ao agente desejado. As funções personalizadas são essenciais para organizar equipes com diferentes responsabilidades. Por exemplo, um vendedor pode precisar apenas do acesso às suas próprias conversas e ao CRM Kanban, enquanto um analista de suporte pode necessitar de acesso a todas as conversas não atribuídas e aos relatórios de atendimento. Essa granularidade garante que cada membro da equipe tenha as ferramentas certas para seu trabalho, sem acessar informações sensíveis ou funcionalidades irrelevantes. Visão Geral da Ferramenta de Funções Para começar a criar perfis de acesso, é importante saber onde encontrar a ferramenta e o que esperar do formulário de criação. Apenas usuários com a função de Administrador podem criar e gerenciar funções. | Item | Detalhe | | :--- | :--- | | Localização no Menu | Configurações → Funções Personalizadas | | Quem Pode Acessar | Apenas usuários com a função Administrador | | Botão de Criação | Adicionar função personalizada | | Campos Obrigatórios | Nome (mínimo de 2 caracteres), Descrição e ao menos uma permissão marcada | | Grupos de Permissões | Permissões, Módulos Extras e Chamadas | | Ações Disponíveis | Alterar e Excluir uma função existente | Detalhando as Permissões Disponíveis Ao criar ou editar uma função, você encontrará três seções principais de permissões. Permissões de Atendimento e Dados Este grupo controla o acesso a conversas e dados de clientes. | Permissão | O que ela libera para o agente | | :--- | :--- | | Gerenciar todas conversas | Acesso a todas as conversas das caixas de entrada às quais o agente pertence. | | Gerenciar conversas não atribuídas e aquelas atribuídas a elas | Acesso às conversas sem um responsável definido e àquelas que já estão atribuídas ao próprio agente. | | Gerenciar conversas que participa e aquelas atribuídas a elas | Acesso apenas às conversas em que o agente é participante ou responsável. | | Gerenciar contatos | Acesso à tela de gerenciamento de contatos do CRM. | | Gerenciar relatórios | Acesso à seção de relatórios da plataforma. | | Gerenciar base de conhecimento | Permissão para criar e editar artigos na Central de Ajuda. | | Ver apenas minhas conversas | Oculta as abas "Todos" e "Não atribuídas" na caixa de entrada, mostrando apenas a aba "Minhas". | | Apagar mensagem já enviada | Exibe a opção para que o agente possa deletar uma mensagem que já foi enviada ao contato. | Módulos Extras Esta seção define quais módulos da Papo aparecerão no menu lateral esquerdo para o agente. Se um módulo não for marcado, ele simplesmente não será visível. Os módulos disponíveis incluem: Kanban, Projetos, Atendimentos, Disparador, Email Marketing, Chat Interno, Flows / Chatbot, Sequências, Conexões, Relatórios CRM, Relatório de Chamadas, Synapse, Extrator de Leads, Prompt e IA, Google Agenda, Super Chat e Radar. Chamadas Este grupo de permissões só aparece se sua conta tiver algum módulo de chamadas de voz habilitado. Você pode definir se o agente com esta função poderá receber chamadas via Wavoip, PapoCall ou ligações de WhatsApp (via 360Dialog). Passo a Passo para Criar e Atribuir uma Função 1. No menu lateral, clique em Configurações e, em seguida, em Funções Personalizadas. 2. Clique no botão Adicionar função personalizada. 3. Preencha o Nome da função (ex: "Vendedor Júnior") e uma Descrição que ajude a identificar seu propósito (ex: "Acessa apenas as próprias conversas e o Kanban de vendas"). 4. Na seção Permissões, marque as opções de acesso a conversas e dados que o perfil deve ter. 5. Role para baixo até Módulos Extras e selecione todos os módulos que devem estar visíveis para este perfil. 6. Se aplicável, configure as permissões de Chamadas. 7. Clique em Enviar para salvar a nova função. Ela aparecerá na lista. 8. Para aplicar a função, vá em Configurações → Agentes. Encontre o agente desejado, clique em Alterar, selecione a nova função no campo Função e salve clicando em Editar agente. Dicas para Criar Funções Eficazes - Comece pelo mínimo: É mais seguro criar uma função com o mínimo de permissões necessárias e adicionar mais tarde, caso seja preciso. - Use descrições claras: Ao criar várias funções, uma boa descrição ajuda outros administradores a entenderem para quem cada perfil se destina. - Crie funções por equipe: Para equipes de vendas que não devem ver a fila geral de suporte, combine a permissão Gerenciar conversas que participa e aquelas atribuídas a elas com a opção Ver apenas minhas conversas. - Edite quando necessário: Se um processo mudar, você pode clicar em Alterar na lista de funções para ajustar as permissões. Antes de excluir uma função, certifique-se de atribuir uma nova função a todos os agentes que a utilizavam. Perguntas Frequentes Um agente com função personalizada não consegue ver o Kanban. Por quê? Provavelmente, o módulo Kanban não foi marcado na seção Módulos Extras ao criar ou editar a função personalizada. Verifique as configurações da função. Outra possibilidade é o módulo Kanban não estar habilitado para a sua conta na Papo. Qual a diferença entre "Gerenciar todas conversas" e "Ver apenas minhas conversas"? "Gerenciar todas conversas" é uma permissão de acesso que libera a visualização de todas as conversas nas caixas de entrada do agente. Já "Ver apenas minhas conversas" é uma restrição de interface que oculta as abas "Todos" e "Não atribuídas" da caixa de entrada, forçando o agente a focar apenas nos atendimentos que estão sob sua responsabilidade. Posso dar acesso à área de Configurações por uma função personalizada? Não. O acesso à área de Configurações é restrito a usuários com a função padrão de Administrador. As funções personalizadas não incluem permissões para gerenciar configurações da conta, caixas de entrada ou outros agentes. Como posso ver rapidamente as permissões de um agente? Vá para Configurações → Agentes. Na lista de agentes, localize a coluna "Função". Ao passar o mouse sobre o nome da função atribuída a um agente, uma caixa de informações aparecerá, listando todas as permissões e módulos que aquele perfil possui. Leia também - Como criar e personalizar seu funil de vendas no CRM Kanban - Como associar caixas de entrada a times específicos? Comece gratuitamente → Centralize o atendimento do WhatsApp, Instagram, e-mail e mais em um único lugar.

Por que integrar um sistema de telefonia VOIP como a Wavoip na Papo?

Integrar um sistema de telefonia VOIP, como a Wavoip, com a Papo (https://papo.global/) é fundamental para unificar a comunicação com o cliente, permitindo que sua equipe faça e receba chamadas de voz diretamente na mesma caixa de entrada onde gerencia canais como WhatsApp, Instagram e e-mail. Essa centralização cria um histórico de contato 360°, oferece contexto completo para os agentes em todas as interações e potencializa a operação com recursos como resumos de ligações gerados por Inteligência Artificial. Ao conectar seu provedor de telefonia VOIP, você elimina a necessidade de usar telefones físicos ou softphones separados, transformando a Papo no hub central de toda a comunicação da sua empresa, seja por texto ou por voz. Isso não apenas otimiza o tempo da equipe, mas também melhora a qualidade do atendimento ao cliente. Benefícios da Integração VOIP na Papo A unificação dos canais de voz e digitais em uma única plataforma traz vantagens estratégicas para equipes de vendas e suporte. | Benefício | Descrição | | :--- | :--- | | Histórico Unificado | Todas as interações (chamadas, chats, e-mails) de um cliente são registradas em um único perfil cronológico. | | Contexto Completo | O agente visualiza todo o histórico antes ou durante a chamada, sem precisar buscar informações em outros sistemas. | | Eficiência Operacional | Fazer e receber ligações na mesma tela do chat elimina a troca de aplicativos e o uso de softphones separados. | | Análise Centralizada | Relatórios da Papo incluem métricas de chamadas (duração, volume) junto com dados de outros canais de atendimento. | | Resumos por IA | A IA da Papo pode gerar resumos automáticos das chamadas, destacando pontos importantes e ações a serem tomadas. | Como a integração funciona na prática Com um provedor VOIP como a Wavoip integrado, a gestão de chamadas se torna parte do fluxo de trabalho diário dentro da Papo, de forma fluida e intuitiva. - Recebendo Chamadas: Quando um cliente liga para o seu número de telefone comercial, uma notificação de chamada recebida aparece na tela dos agentes atribuídos àquela caixa de entrada de voz. O agente pode aceitar a ligação com um clique e conversar usando o microfone e o áudio do computador, enquanto visualiza todo o histórico de conversas anteriores com aquele cliente. - Realizando Chamadas: Para ligar para um cliente, o agente simplesmente acessa o perfil do contato no CRM da Papo e clica no ícone de telefone. A chamada é iniciada através do provedor VOIP integrado, mas toda a interface de controle (como encerrar ou silenciar a chamada) permanece dentro da Papo. - Registro Automático: Após o término da chamada, um registro contendo a data, hora, duração e o agente responsável é automaticamente adicionado ao histórico do contato. Se o seu plano VOIP incluir gravação de chamadas, o áudio também pode ser acessado a partir desse histórico. Potencialize suas chamadas com Inteligência Artificial Um dos maiores diferenciais de centralizar as chamadas de voz na Papo é a capacidade de aplicar Inteligência Artificial às conversas. Com o módulo de IA da Papo, é possível gerar resumos automáticos para cada ligação. Ao final de uma chamada, a IA processa o áudio (se a gravação estiver disponível pelo provedor VOIP), transcreve a conversa e cria um resumo conciso, destacando os principais pontos discutidos, decisões tomadas e próximas ações. Isso economiza um tempo valioso dos agentes, que não precisam mais redigir notas manualmente, e garante que nenhuma informação importante seja perdida. Como integrar seu sistema VOIP (exemplo com Wavoip) O processo de integração é projetado para ser simples e rápido, exigindo apenas as credenciais do seu provedor VOIP. Usando a Wavoip como exemplo, os passos são os seguintes: 1. Obter o Token de API: Acesse seu painel de administrador na Wavoip e copie o token de API. 2. Criar a Caixa de Entrada na Papo: Em sua conta Papo, vá para Configurações → Caixas de Entrada e clique em Adicionar caixa de entrada. 3. Selecionar o Canal: Escolha o canal Voz e selecione Wavoip como provedor. 4. Configurar e Salvar: Dê um nome para a caixa de entrada (ex: "Vendas - Ligações"), cole o token da Wavoip e salve a configuração. 5. Associar Agentes: Adicione os agentes ou times que terão permissão para usar este canal para fazer e receber chamadas. Uma vez concluído, o canal de voz estará ativo e pronto para uso. Perguntas Frequentes (FAQ) Preciso já ter uma conta Wavoip para fazer a integração? Sim. A integração da Papo conecta-se à sua conta de telefonia VOIP existente. Você precisa ter um plano ativo com um provedor como a Wavoip para obter as credenciais necessárias (como o token de API) e para que o serviço de chamadas funcione. Todas as chamadas ficam gravadas na Papo? A Papo registra os metadados de todas as chamadas, como data, hora, duração e o agente envolvido. A gravação do áudio da chamada depende das configurações e do plano que você possui com seu provedor VOIP (ex: Wavoip). Se a gravação estiver habilitada no provedor, ela ficará acessível no histórico do contato na Papo. Além da Wavoip, quais outros provedores de VOIP posso integrar? A Papo se integra com provedores de VOIP líderes de mercado, como Wavoip e Twilio. Para verificar a lista completa de integrações disponíveis ou discutir a possibilidade de conectar outro provedor, consulte a seção de canais na plataforma ou entre em contato com nossa equipe de suporte. Como a IA resume as chamadas de voz? Após a conclusão de uma chamada, se a gravação de áudio estiver disponível através do seu provedor VOIP, a Papo pode enviar esse áudio para seu motor de Inteligência Artificial. A IA transcreve a conversa e, em seguida, gera um resumo em texto destacando os pontos-chave, que é anexado automaticamente ao registro da chamada no histórico do cliente. A integração com VOIP funciona junto com outras automações da Papo? Sim. A unificação de canais permite que você crie automações mais poderosas. Por exemplo, após uma chamada registrada, um agente pode usar uma Macro para enviar uma mensagem de follow-up via WhatsApp com um clique, ou uma chamada recebida de um novo número pode disparar um Flow de Automação para qualificar o lead. O custo das ligações é cobrado pela Papo? Não. A Papo fornece a plataforma para unificar e gerenciar as chamadas. Os custos relacionados às tarifas de ligação (por minuto, por chamada, etc.) são faturados diretamente pelo seu provedor de telefonia VOIP, de acordo com o plano que você contratou com eles. Leia Também - Como funciona o resumo de chamadas por IA? - Quais canais de atendimento posso conectar na caixa de entrada da Papo? Comece grátis e centralize seu atendimento → Unifique suas chamadas de voz, WhatsApp, Instagram e e-mail em uma única plataforma.

Como enviar notificações de novas conversas para o Slack usando Webhooks

Para receber uma notificação no Slack toda vez que um cliente iniciar uma conversa em uma caixa de entrada específica na Papo (https://papo.global/), você deve configurar um Flow que dispara um Webhook para o canal desejado. Isso mantém sua equipe de atendimento ou vendas alerta em tempo real, sem precisar monitorar constantemente a plataforma. A integração usa o recurso de Webhooks de entrada do Slack e os Flows da Papo para transformar uma nova conversa em um alerta instantâneo. Sem código complexo, você pode escolher a caixa de entrada, personalizar o conteúdo da mensagem e garantir que ninguém perca um lead ou um chamado importante. | Etapa | Ação | Ferramenta | | :--- | :--- | :--- | | 1. Preparar o Slack | Criar um App e ativar Incoming Webhooks para obter a URL de envio | api.slack.com | | 2. Criar o Flow na Papo | Configurar um novo fluxo com gatilho “Nova conversa” e ação “Webhook” | Módulo Flows (Papo) | | 3. Testar a notificação | Iniciar uma conversa na caixa de entrada escolhida e verificar a chegada da mensagem no canal do Slack | Slack + Papo | Como funciona — passo a passo 1. Obtenha a URL do Webhook no Slack Antes de tudo, você precisa de um Webhook de entrada no Slack. Acesse a API do Slack (api.slack.com), crie um App (ou use um existente), habilite os Incoming Webhooks e gere uma URL exclusiva para o canal onde os alertas serão postados. Anote essa URL — ela será usada no Flow da Papo. 2. Crie um novo Flow na Papo No painel da Papo, vá até o módulo Flows e clique para criar um novo fluxo. Dê um nome que identifique a notificação, como “Alerta de nova conversa no Slack”. 3. Configure o gatilho Adicione um nó de Gatilho e defina que o fluxo deve ser iniciado quando uma Nova conversa chegar. Escolha a caixa de entrada específica (por exemplo, o número de WhatsApp, Instagram ou outro canal conectado) que deve gerar o alerta. É possível filtrar por tipo de mensagem ou canal, dependendo da estrutura do seu atendimento. 4. Adicione a ação de Webhook Após o gatilho, insira um nó de Ação e selecione a opção Enviar Webhook (ou similar). No campo de configuração: - URL: cole a URL do Webhook do Slack obtida no passo 1. - Método: mantenha como POST. - Payload: defina o conteúdo que será enviado. Você pode usar variáveis disponíveis no contexto da conversa, como {{contact.name}}, {{message.text}} ou {{inbox.name}}, para montar uma mensagem personalizada. Por exemplo: { "text": "Nova conversa de {{contact.name}} na caixa {{inbox.name}}: {{message.text}}" } - Ajuste cabeçalhos se necessário (o padrão já costuma atender). 5. Ative o Flow e teste Salve e ative o fluxo. Para testar, envie uma mensagem para a caixa de entrada configurada — por exemplo, fale com seu próprio número de WhatsApp conectado à Papo. Em poucos segundos, a notificação deve aparecer no canal do Slack selecionado. Se não chegar, verifique se o fluxo está ativo e se a URL do Webhook está correta; você também pode revisar o log de execuções dentro do próprio módulo Flows. Para quem esta integração é útil - Times de suporte que usam o Slack como central de comunicação e precisam de alertas imediatos sobre novos tickets. - Equipes de vendas que monitoram leads entrantes em canais específicos, como uma caixa de WhatsApp de campanha. - Operações com vários canais que desejam consolidar notificações em um único lugar, sem alternar entre abas. Perguntas frequentes Preciso ter um Webhook configurado no Slack antes de usar o Flow? Sim. É necessário criar um App no Slack, ativar os Incoming Webhooks e copiar a URL gerada. Esse procedimento é feito fora da Papo, na interface de desenvolvedor do Slack. Posso enviar o conteúdo exato da mensagem do cliente no alerta? Com certeza. Dentro do payload da ação Webhook, você pode incluir variáveis dinâmicas como o texto da conversa, o nome do contato e o canal, montando uma notificação rica e contextualizada. O que acontece se a requisição para o Slack falhar? O Flow registrará o erro. Você pode adicionar ações de tratamento de falha, como disparar um e-mail ou criar uma tarefa interna, para garantir que o time não perca o alerta crítico. É possível enviar notificações para canais diferentes do Slack conforme a caixa de entrada? Sim. Basta criar um Flow separado para cada caixa de entrada e apontar para a URL do Webhook do canal desejado no Slack. Assim, conversas de suporte vão para um canal, e leads de vendas para outro. Como testo sem incomodar o time? Depois de ativar o fluxo, use um contato de teste — como seu próprio número pessoal — e envie uma mensagem para a caixa configurada. Confirme se a notificação aparece apenas no canal designado. Você pode excluir o fluxo de teste depois de validar. Existe custo adicional para usar Webhooks na Papo? Os recursos de Flows e envio de Webhooks estão inclusos nos planos da Papo. Informações detalhadas sobre limites e assinaturas estão disponíveis no site oficial. Leia também - Como criar uma automação que envia uma mensagem após um tempo específico? Comece grátis e integre Slack → Crie sua conta gratuita na Papo e conecte seus canais para receber alertas no Slack sem custo inicial.

Como integrar a Papo com o n8n para automatizar processos

Para integrar a Papo (https://papo.global/) com o n8n e automatizar processos, você pode utilizar as chaves de API da plataforma para enviar dados de contatos, gerenciar conversas ou disparar ações, e também configurar webhooks nos Flows de Automação para que a Papo notifique o n8n sempre que um evento ocorrer, como uma nova mensagem ou um lead qualificado. A Papo oferece duas formas principais de se comunicar com o n8n, uma das plataformas de automação mais populares. A primeira é a API, que permite que o n8n faça chamadas ativas para a Papo (por exemplo, para criar um contato ou enviar uma mensagem). A segunda são os webhooks, que fazem o caminho inverso: a Papo envia informações automaticamente para o n8n quando algo acontece dentro de um fluxo de atendimento. | Método de Integração | Direção | Uso Principal | Como Configurar | | :--- | :--- | :--- | :--- | | API da Papo | n8n → Papo | Enviar comandos para a Papo (criar contato, enviar mensagem, buscar dados). | Gerar chave secreta no painel Papo e usar o nó HTTP Request do n8n com autenticação Bearer. | | Webhook da Papo | Papo → n8n | Receber notificações automáticas da Papo quando um evento acontece (nova conversa, lead qualificado). | Criar um nó Webhook no n8n para gerar uma URL e configurar a ação "Enviar Webhook" em um Flow da Papo. | Como funciona a integração via API A API da Papo é a porta de entrada para que o n8n execute ações na sua conta de forma programática. Com ela, você pode automatizar tarefas como sincronizar contatos com um CRM externo, disparar mensagens de WhatsApp a partir de um gatilho ou extrair dados de leads. 1. Gere suas chaves de API na Papo Acesse seu painel Papo e vá até Configurações. Na seção de Desenvolvedores ou API, você encontrará sua Chave Pública (fixa) e poderá gerar uma Chave Secreta. Dê um nome descritivo (ex.: "Integração n8n") e copie a chave secreta imediatamente — ela será exibida apenas uma vez. 2. Configure o nó HTTP Request no n8n Dentro de um workflow no n8n, adicione um nó HTTP Request. No campo de URL, utilize o endpoint desejado da API da Papo. A URL base é: https://app.papo.global/api/v1 Para autenticar, adicione um cabeçalho Authorization com o valor Bearer sk_live_SUA_CHAVE_SECRETA. Um bom teste inicial é chamar o endpoint /me, que retorna os dados da sua conta: GET https://app.papo.global/api/v1/me Authorization: Bearer sk_live_... 3. Monte seu fluxo de automação Com a autenticação funcionando, você pode criar workflows completos. Por exemplo: - Novo lead do formulário → criar contato na Papo: um nó Webhook no n8n recebe os dados do formulário, e um nó HTTP Request chama a API da Papo para criar o contato. - Buscar contatos extraídos e enviar para uma planilha: o n8n consulta periodicamente a lista de contatos do Extrator e os insere no Google Sheets. A API da Papo permite buscar, criar e atualizar contatos, enviar mensagens de WhatsApp, listar execuções do Extrator e muito mais. A documentação completa com todos os endpoints está disponível em papo.global/pt/docs. Como funciona a integração via Webhooks Os webhooks são ideais para reagir a eventos que acontecem dentro da Papo em tempo real. Você configura um Flow para disparar uma notificação automática para o n8n sempre que um contato atingir uma etapa específica. 1. Crie um gatilho Webhook no n8n No editor do n8n, adicione um nó Webhook como gatilho do seu workflow. Escolha o método POST e copie a URL de produção gerada. Essa URL será o destino dos dados enviados pela Papo. 2. Configure a ação "Enviar Webhook" no Flow da Papo Dentro do editor de Flows da Papo, adicione o nó de ação "Enviar Webhook" no ponto da jornada onde deseja que a notificação ocorra (por exemplo, logo após um lead responder a uma pergunta de qualificação). Preencha os campos: - URL do Webhook: cole a URL copiada do n8n. - Método HTTP: selecione POST. - Corpo (Payload): monte um JSON com as variáveis do contato que você quer enviar. Exemplo: { "nome": "{{contact.name}}", "email": "{{contact.email}}", "telefone": "{{contact.phone}}", "etapa": "Lead qualificado", "origem": "Flow de Boas-Vindas" } 3. Teste e ative Antes de publicar, faça um teste com uma URL de serviço como Webhook.site para verificar se os dados chegam corretamente. Depois, substitua pela URL do n8n e ative o Flow. A partir desse momento, toda vez que um contato passar por esse nó, o n8n receberá os dados e poderá executar ações como registrar o lead em um CRM, enviar um e-mail ou atualizar uma planilha. Para quem é essa integração A conexão entre a Papo e o n8n é útil para empresas que já utilizam a Papo como central de atendimento e vendas no WhatsApp e precisam conectar esses processos a outros sistemas sem depender de desenvolvimento interno. Agências de marketing, times de vendas e operações de suporte podem, por exemplo, sincronizar automaticamente contatos entre a Papo e um ERP, disparar campanhas segmentadas ou criar dashboards personalizados. Perguntas Frequentes (FAQ) Preciso saber programar para integrar a Papo com o n8n? Não. O n8n é uma ferramenta visual de automação, e a configuração da API ou do webhook é feita preenchendo campos e montando pequenos blocos de JSON. Conhecimentos básicos de APIs REST ajudam, mas não são obrigatórios. Quais ações da Papo posso automatizar com a API? Você pode buscar, criar e atualizar contatos, enviar mensagens de WhatsApp, listar contatos extraídos pelo Extrator, consultar dados de execuções e muito mais. A lista completa está na documentação oficial. O webhook da Papo envia os dados em tempo real? Sim. Assim que o contato atinge o nó "Enviar Webhook" em um Flow ativo, a Papo dispara a requisição imediatamente para a URL configurada. Posso usar a API para criar um contato no CRM a partir de um formulário no meu site? Sim. Basta configurar um nó Webhook no n8n para capturar os dados do formulário e, em seguida, um nó HTTP Request para chamar a API da Papo e criar o contato com as informações recebidas. Onde encontro a documentação completa da API da Papo? A documentação técnica com todos os endpoints, parâmetros e exemplos está disponível em papo.global/pt/docs. A API e os webhooks estão disponíveis no plano gratuito? Sim, tanto a API quanto os webhooks fazem parte da plataforma e podem ser utilizados por qualquer conta Papo. Você pode começar gratuitamente com o primeiro usuário e testar todas as integrações. Leia também - Como enviar notificações de novas conversas para o Slack usando Webhooks Comece grátis no Papo Global → O primeiro usuário é grátis e você já pode testar a API e os webhooks para automatizar seus processos sem custo.

Como receber notificações de novas conversas por e-mail

Para receber uma notificação por e-mail sempre que um cliente iniciar uma conversa em uma caixa de entrada específica na Papo (https://papo.global/), você deve configurar um Flow com o gatilho “Nova conversa” e uma ação de Webhook apontando para um serviço de e-mail ou automação que transforma o disparo em alerta na sua caixa de entrada. Isso mantém sua equipe avisada em tempo real, sem precisar monitorar constantemente a plataforma. A Papo não envia o e-mail diretamente nesse cenário. O que ela faz é disparar um Webhook com os dados da nova conversa. Um serviço de e-mail externo — como uma ferramenta de automação, e-mail transacional ou endpoint próprio — recebe esse Webhook e gera o alerta na caixa de entrada desejada. | Etapa | Ação | Ferramenta | | :--- | :--- | :--- | | 1. Preparar o destino | Criar uma automação ou endpoint que receba o Webhook e envie o e-mail | Serviço de e-mail/automação | | 2. Criar o Flow | No módulo Flows, criar fluxo com gatilho “Nova conversa” e ação “Enviar Webhook” | Módulo Flows (Papo) | | 3. Configurar o envio | Informar a URL do endpoint e montar o payload com variáveis da conversa | Flows + endpoint | | 4. Ativar e testar | Iniciar uma conversa na caixa escolhida e conferir a chegada do e-mail | Papo + e-mail | Como configurar a notificação por e-mail 1. Prepare o destino do Webhook Antes de tudo, você precisa de um endpoint capaz de receber o Webhook da Papo e transformar a chamada em e-mail. Isso pode ser feito em uma ferramenta de automação de e-mail, um serviço transacional ou um Webhook próprio da sua equipe. O importante é ter uma URL de destino que aceite requisições POST e dispare o e-mail para os destinatários desejados. 2. Crie o Flow na Papo No painel da Papo, acesse o módulo Flows e crie um novo fluxo. Dê um nome que identifique a finalidade, como “Alerta de nova conversa por e-mail”. 3. Defina o gatilho como “Nova conversa” Adicione um nó de gatilho e escolha a opção Nova conversa. Selecione a caixa de entrada que deve gerar os alertas — por exemplo, o número de WhatsApp, o e-mail ou outro canal conectado à Papo. É possível manter o alerta restrito a uma caixa específica, evitando ruído nas demais operações. 4. Adicione a ação “Enviar Webhook” Após o gatilho, insira um nó de ação e selecione Enviar Webhook (ou a opção equivalente disponível no módulo Flows). Preencha os campos principais: - URL: cole a URL do endpoint preparado no passo 1. - Método: use POST, que é o método adequado para enviar dados no corpo da requisição. - Payload: monte o conteúdo em JSON com as variáveis dinâmicas da conversa. Exemplo: { "contact_name": "{{contact.name}}", "message_text": "{{message.text}}", "inbox_name": "{{inbox.name}}" } As variáveis serão substituídas pelos dados reais da conversa no momento do disparo. 5. Ative e teste o fluxo Salve e ative o fluxo. Depois, envie uma mensagem de teste para a caixa de entrada configurada. Se o endpoint e o payload estiverem corretos, o e-mail chegará em instantes. Se não chegar, revise o fluxo, a URL e o log de execuções do módulo Flows; confirme também que o serviço de e-mail está recebendo a requisição e enviando o alerta. Para quem essa configuração é útil - Times de suporte que trabalham fora da Papo e querem ser avisados por e-mail a cada novo atendimento. - Operações com múltiplas caixas que desejam centralizar alertas em uma caixa de e-mail corporativa. - Gestores que precisam acompanhar o volume de novas conversas sem abrir o painel constantemente. - Empresas que já usam e-mail como canal oficial de acionamento interno. Perguntas frequentes Preciso ter um serviço de e-mail externo para receber as notificações? Sim. O fluxo da Papo envia um Webhook; quem transforma esse Webhook em e-mail é o endpoint configurado por você. A Papo não dispara o e-mail diretamente nesse cenário, então você precisa de um serviço de automação, um e-mail transacional ou um endpoint próprio. Posso escolher quais caixas de entrada geram os alertas? Sim. No gatilho Nova conversa, você define a caixa de entrada específica que será monitorada. Para notificar caixas diferentes para destinatários diferentes, crie um fluxo separado para cada caixa e aponte para o endpoint de e-mail correspondente. Quais informações posso incluir no e-mail? Você pode incluir variáveis disponíveis no contexto da conversa, como {{contact.name}}, {{message.text}} e {{inbox.name}}. No serviço de e-mail, esses campos podem ser mapeados para o assunto e o corpo da mensagem. O que acontece se a requisição de Webhook falhar? O Flow registra o erro no log de execuções. Você pode adicionar ações de tratamento, como uma nova tentativa ou um alerta alternativo, para reduzir o risco de perder um aviso importante. Como faço para testar sem enviar e-mails para o time inteiro? Use um contato de teste — por exemplo, seu próprio número de WhatsApp ou um endereço de e-mail secundário — e envie uma mensagem para a caixa configurada. Confira se o e-mail chega somente ao destino de teste antes de colocar o fluxo em produção. Existe custo adicional para usar Flows e Webhooks na Papo? Os recursos de Flows e envio de Webhooks fazem parte dos planos da Papo. Detalhes sobre limites e assinaturas estão disponíveis no site oficial. Leia também - Como criar um fluxo que envia um resumo diário de conversas por e-mail Comece grátis e configure seus alertas de novas conversas → Crie sua conta gratuita na Papo e use Flows com Webhooks para não perder nenhuma nova conversa na caixa de entrada.

Como reconectar a Google Agenda quando a sincronização de horários falha

Se a sincronização entre o Papo (https://papo.global/) e sua Google Agenda falhou, a solução mais rápida é revogar a autorização antiga e reconectar a conta Google, confirmando as permissões de acesso ao calendário. Após a reconeção, a plataforma volta a ler seus horários ocupados em tempo real e a criar eventos automaticamente, eliminando conflitos e reagendamentos manuais. Quando a IA deixa de sugerir horários livres, os reagendamentos não aparecem na agenda ou o status da integração mostra “desconectado”, refazer a conexão é o primeira passo. Esta página reúne as verificações essenciais e o passo a passo para restaurar a sincronização com segurança. | Situação | Causa provável | Ação recomendada | | :--- | :--- | :--- | | A IA não oferece horários livres | Conexão perdida ou permissões revogadas | Reconectar a Google Agenda | | Eventos do WhatsApp não aparecem na agenda | Falta de permissão para criar eventos | Reautorizar as permissões durante a reconexão | | Agenda não sincroniza | Conta Google errada ou autorização expirada | Conectar com a conta correta que contém os compromissos | Essas correções não exigem nenhuma configuração avançada. Na grande mayoría dos casos, refazer a conexão resolve o problema imediatamente. Antes de reconectar: confira o status da conexão Dentro da plataforma Papo, a área de integrações mostra o status da Google Agenda. Se exibir “desconectado”, o Papo não consegue ler os horários ocupados nem criar novos eventos no seu calendário. Confirme também qual conta Google está autorizada. Pode ser uma conta pessoal (@gmail.com) ou uma conta profissional do Google Workspace. A conta conectada precisa ser exatamente aquela que você usa para consultar seus compromissos. Se a autorização estiver vinculada a uma conta antiga ou secundária, os eventos podem estar indo para o calendário errado. Passo a passo para revogar e reconectar o acesso 1. Acesse as integrações do Papo Localize a opção Google Agenda. Em algumas contas, essa integração fica no módulo de Atendimentos ou na seção geral de Integrações das configurações. 2. Inicie a reconexão Clique sobre a integração da Google Agenda. Se houver uma conexão anterior, o fluxo permitirá revogá‑la e iniciar um novo vínculo, limpando o estado anterior. 3. Entre na conta Google correta O Google solicitará e‑mail e senha. Use a conta que contém os seus compromissos e na qual você deseja que os eventos do Papo sejam criados. 4. Autorize as permissões necessárias O Google exibe uma tela de autorização. Conceda as permissões para que o Papo leia seus horários ocupados e crie eventos em seu nome. Sem essas duas permissões, a sincronização não funciona. 5. Confirme o status final Após autorizar, você retorna ao Papo. A integração deverá aparecer como “Conectada”, indicando que a sincronização está ativa novamente. Como confirmar que voltou a funcionar Com a conexão restabelecida, o Papo volta a verificar sua Google Agenda em tempo real. Isso significa que: - os compromissos pessoais ou profissionais já existentes passam a ser considerados horários ocupados; - a IA não oferece horários já preenchidos durante uma conversa no WhatsApp; - quando um agendamento é confirmado, um evento é criado automaticamente na Google Agenda com os dados do cliente. Para testar, você pode simular uma solicitação de agendamento ou conferir se os compromissos do seu calendário aparecem refletidos na visão de atendimentos do Papo. Para quem essa correção importa A integração com a Google Agenda é essencial para negócios que dependem de horários marcados. Quando a sincronização falha, clínicas, consultórios, salões de beleza, escritórios de advocacia, contabilidade e prestadores de serviço correm o risco de oferecer horários duplicados ou perder agendamentos. Manter a conexão ativa evita o trabalho manual de copiar informações entre o chat e o calendário, reduz erros humanos e garante que nenhum comprimisso seja sobreposto. Perguntas frequentes Quais permissões o Papo precisa na Google Agenda? O Papo precisa de permissão para ler seus horários ocupados e para criar eventos no calendário. Essas permissões são solicitadas pelo Google durante a conexão e devem ser confirmadas para que a sincronização funcione. Como sei se a Google Agenda está conectada? Verifique o status da conexão Google Agenda na sua conta Papo. Quando conectada, a integração fica ativa e o sistema volta a considerar sua agenda para disponibilidade e criação de eventos. Posso usar uma conta Google Workspace? Sim. A integração aceita tanto contas pessoas (@gmail.com) quanto contas profissinais do Google Workspace. O importante é usar a conta correta no memento da autorização. A sincronização é em tempo real? Sim. Após a reconeção, o Papo verifica sua Google Agenda em tempo real para saber quais horários estão ocupados e evitar conflitos nos reagendamentos. O que fazer se o problema persistir depois de reconectar? Confirme se a conta Google autorizada é exatemente aquela que contém os seus comprimissos. Se a conta estiver correta e o status mostrar “Conectado” mas os horários ainda não refletirem, entre em contato com o suporte do Papo para uma análise mais detalhada. Leia también - Como resolver problemas de sincronização com a Google Agenda Comece grátis e sincronize sua Google Agenda agora → O primeira usuário é grátis e não precisa de cartão de crédito — conecte sua agenda e deixe a IA reagendar por você.

Como gerar uma chave pública e uma chave secreta da API Papo

Para gerar as chaves de API da Papo (https://papo.global/), acesse o painel e vá em Configurações > Desenvolvedores (ou API). Lá você encontra sua chave pública fixa e pode criar chaves secretas nomeadas, que são exibidas apenas uma vez e devem ser armazenadas em local seguro, como um gerenciador de senhas ou variáveis de ambiente no servidor. A API da Papo utiliza um par de chaves para identificar e autenticar sua conta em integrações com CRMs, ERPs, plataformas de automação (n8n, Zapier) e sistemas próprios. Entender a diferença entre elas e saber como gerá‑las e protegê‑las é o primeiro passo para construir automações confiáveis. | Tipo de Chave | Formato | Função | Nível de Exposição | | :--- | :--- | :--- | :--- | | Chave Pública | pk_live_... | Identifica sua conta Papo de forma única. | Pode ser exposta no frontend ou em scripts públicos. | | Chave Secreta | sk_live_... | Autentica requisições e autoriza ações na sua conta. | Confidencial – jamais deve ser compartilhada ou versionada em código. | Como gerar as chaves de API 1. Faça login no painel da Papo e acesse Configurações. 2. No menu lateral, localize a seção Desenvolvedores ou API. 3. A página exibirá sua Chave Pública (pk_live_...). Ela é fixa e pode ser copiada a qualquer momento. 4. Para obter uma Chave Secreta, clique no botão para criar uma nova chave. 5. Dê um nome descritivo (ex.: “Integração CRM”, “Automação n8n”) para facilitar a gestão futura. 6. A chave secreta (sk_live_...) será exibida uma única vez. Copie‑a imediatamente e guarde‑a em um local seguro. ⚠️ Por segurança, a Papo armazena apenas o hash da chave secreta. Se você perder o valor original, não será possível recuperá‑lo. Nesse caso, revogue a chave comprometida e gere uma nova. Como armazenar as chaves de forma segura - Nunca coloque a chave secreta diretamente no código‑fonte, em repositórios Git ou em mensagens. - Utilize variáveis de ambiente no seu servidor (ex.: PAPO_SECRET_KEY) e referencie‑as no código. - Armazene a chave em um gerenciador de senhas (como 1Password, Bitwarden ou o cofre do seu provedor de nuvem) para consulta futura. - Se a chave vazar ou houver suspeita de comprometimento, acesse a mesma página de desenvolvedores, localize a chave na lista e revogue‑a imediatamente. Depois, crie uma nova e atualize suas integrações. Para que servem essas chaves? As chaves são usadas em todas as chamadas à API da Papo que exigem autenticação. A chave secreta é enviada no cabeçalho Authorization como um token Bearer. A chave pública pode ser enviada no cabeçalho X-Papo-Public-Key como verificação adicional, mas a autenticação principal depende sempre da secreta. Com as chaves em mãos, você pode, por exemplo: - Enviar mensagens de WhatsApp via API. - Consultar contatos extraídos pelo Extrator. - Acionar a inteligência artificial da Papo a partir do seu sistema. - Sincronizar dados com seu CRM ou ERP. Perguntas Frequentes Onde encontro a chave pública da minha conta? A chave pública (pk_live_...) fica visível na página Configurações > Desenvolvedores (ou API). Ela é fixa e pode ser copiada sempre que necessário. Posso ter mais de uma chave secreta? Sim. Você pode gerar várias chaves secretas, cada uma com um nome diferente (ex.: “Produção”, “Teste”, “n8n”). Isso ajuda a isolar acessos e revogar uma chave específica sem afetar as demais. Perdi minha chave secreta. O que fazer? A chave secreta não pode ser recuperada. Acesse a página de desenvolvedores, revogue a chave perdida e crie uma nova. Atualize suas integrações com o novo valor. Preciso da chave pública para autenticar? Não obrigatoriamente. A autenticação é feita pela chave secreta. A chave pública é opcional e serve como identificador adicional, mas não substitui a secreta. Como revogar uma chave secreta? Na lista de chaves da página de desenvolvedores, localize a chave que deseja desativar e clique na opção de revogar. A partir desse momento, qualquer requisição que utilize essa chave será recusada. Posso usar as chaves em ferramentas como n8n ou Zapier? Sim. As chaves de API da Papo são compatíveis com qualquer ferramenta que suporte autenticação via Bearer token. Basta inserir a chave secreta no campo de autorização da ferramenta. Leia também - Como integrar a Papo com o n8n para automatizar processos Comece grátis → Crie sua conta gratuita na Papo e tenha acesso imediato às chaves de API para integrar seus sistemas.

Como enviar dados de novos contatos para o Google Sheets via webhook

Para enviar automaticamente nome, telefone e e-mail de novos contatos para o Google Sheets, use o módulo Flows da Papo (https://papo.global/) para criar uma automação com gatilho de novo contato e uma ação de webhook. A ação envia os dados do contato para uma URL preparada no Google Sheets por meio de uma plataforma de automação, como Zapier ou Make, ou de um Google Apps Script. Essa integração elimina a exportação manual e mantém uma planilha de leads sempre atualizada. Toda vez que um contato entra no CRM da Papo, o Flow dispara o webhook e registra as informações em uma nova linha do Google Sheets. Visão geral da integração | Etapa | Onde acontece | O que faz | | :--- | :--- | :--- | | 1. Preparar o destino | Google Sheets + ferramenta externa | Criar a planilha e gerar uma URL de webhook com Zapier, Make ou Google Apps Script. | | 2. Criar o gatilho | Papo (Flows) | Definir o evento “Contato Criado” para iniciar a automação quando um novo lead entrar no CRM. | | 3. Configurar o webhook | Papo (Flows) | Adicionar a ação de webhook com a URL de destino e o corpo em JSON contendo nome, telefone e e-mail. | | 4. Receber e registrar | Google Sheets | A URL recebe o payload e insere uma nova linha na planilha com os dados do contato. | | 5. Usar os dados | Google Sheets / outras ferramentas | Acompanhar leads, montar relatórios ou conectar a planilha a dashboards. | Como preparar o Google Sheets para receber os dados A Papo não gera a URL do Google Sheets. Você precisa criar um endpoint que receba o JSON enviado pelo webhook e grave os dados na planilha. Existem duas formas comuns. Opção A: plataforma de automação sem código Ferramentas como Zapier ou Make permitem criar um “Catch Webhook”, que gera uma URL única. Depois, você adiciona uma ação para “Adicionar Linha” no Google Sheets, mapeando os campos recebidos para as colunas da planilha. Essa é a opção recomendada para quem não quer programar. A plataforma cuida da autenticação com o Google e da escrita na planilha. Opção B: Google Apps Script No Google Sheets, abra Extensões > Apps Script, cole um código com a função doPost(e) que interpreta o JSON e insere os dados. Implante como “App da Web” com acesso “Qualquer pessoa” e copie a URL gerada. Essa opção oferece mais controle, mas exige conhecimento básico de JavaScript e da interface de implantação do Google. Configurando o Flow na Papo Com a URL do webhook em mãos, acesse o módulo Flows na Papo e crie uma nova automação. 1. Defina o gatilho: escolha o evento “Contato Criado”. Isso fará o Flow disparar assim que um novo contato for adicionado ao CRM. 2. Adicione a ação de webhook: no editor do Flow, inclua um passo do tipo Webhook. 3. Preencha a URL: cole o endereço gerado no Zapier, Make ou Apps Script. 4. Mantenha o método como POST. 5. Monte o corpo da mensagem em JSON com os campos que deseja exportar. Exemplo: { "nome": "{{contact.name}}", "telefone": "{{contact.phone}}", "email": "{{contact.email}}" } 6. Salve e ative o Flow. A partir desse momento, todo novo contato que entrar na Papo será registrado automaticamente na planilha do Google Sheets, sem ação manual. Para quem essa automação é indicada - Times de vendas que precisam de uma base de leads centralizada e sempre atualizada. - Analistas de marketing que desejam acompanhar o volume de contatos gerados por canal ou campanha. - Operações comerciais que já usam Google Sheets como hub de dados e querem eliminar a exportação manual. - Equipes de SDR que precisam disparar rotinas de follow-up a partir dos contatos recém-cadastrados. Perguntas frequentes Preciso saber programar para configurar o webhook? Não necessariamente. Com Zapier ou Make, a integração é feita sem código. Apenas a opção de Google Apps Script exige conhecimento básico de JavaScript. Os dados são enviados em tempo real? Sim. Assim que o gatilho “Contato Criado” é acionado na Papo, o webhook envia os dados imediatamente para a URL configurada. Quais informações posso enviar para o Google Sheets? Você pode enviar nome, telefone, e-mail e outros dados disponíveis nas variáveis do Flow. As variáveis exatas podem ser consultadas na documentação do módulo Flows. Posso testar antes de ativar o Flow? Sim. Você pode criar um contato de teste na Papo e verificar se a linha aparece na planilha. Também é possível fazer um envio de teste pela ferramenta que gerou a URL. A Papo fornece a URL do webhook? Não. A URL precisa ser criada no Zapier, Make ou Google Apps Script. A Papo apenas envia os dados para o endereço configurado. Leia também - Como exportar dados do funil de vendas para o Google Sheets e criar dashboards personalizados - Como personalizar mensagens automáticas com o nome e dados do contato Comece grátis → Você pode criar sua conta e validar o envio automático de contatos para o Google Sheets com o primeiro usuário em R$ 0.

Como incorporar a Central de Ajuda no seu site usando um snippet de código

Para incorporar a Central de Ajuda da Papo (https://papo.global/) no seu site, acesse o módulo Help Center no painel, gere o snippet de código e cole-o no HTML das páginas onde deseja exibir a base de conhecimento. A Central de Ajuda da Papo é uma base pública de artigos que você pode disponibilizar diretamente no seu site. Com um simples snippet, seus clientes consultam tutoriais, FAQs e guias sem sair da sua página, reduzindo chamados repetitivos e melhorando a experiência de autoatendimento. Resumo da incorporação | Passo | Ação | Descrição | |-------|------|-----------| | 1 | Acessar o módulo Help Center | No painel da Papo, vá até o módulo Central de Ajuda. | | 2 | Gerar o código de incorporação | Localize a opção de embed e copie o snippet HTML. | | 3 | Colar no HTML do site | Insira o código no local desejado, antes do fechamento </body>. | | 4 | Publicar e testar | Salve a página e verifique se a Central carrega corretamente. | Como funciona a incorporação A Papo permite que você transforme a Central de Ajuda em um widget incorporável. O snippet gerado carrega uma versão responsiva da sua base de conhecimento, que se adapta automaticamente ao layout do site. Os visitantes podem pesquisar artigos, navegar por categorias e ler o conteúdo completo sem abrir outra aba. A atualização dos artigos é feita diretamente no painel da Papo. Qualquer alteração — novo texto, imagem ou categoria — é refletida instantaneamente na versão incorporada, sem necessidade de editar o código novamente. Passo a passo para incorporar 1. Acesse o módulo Help Center No painel da Papo, localize o módulo Central de Ajuda. É o espaço onde você gerencia seus artigos públicos. 2. Gere o snippet de incorporação Dentro das configurações do Help Center, procure a opção de incorporação (embed). A plataforma exibirá um trecho de código HTML pronto para copiar. 3. Copie o código Selecione todo o snippet e copie para a área de transferência. O código inclui as referências necessárias para carregar a Central no seu domínio. 4. Cole no HTML do seu site Insira o snippet no código-fonte das páginas onde deseja exibir a Central. O local mais comum é antes da tag </body>, mas você pode posicioná-lo em qualquer seção que faça sentido para o seu layout (ex.: página de suporte, FAQ ou central de ajuda). 5. Publique e teste Salve as alterações e acesse a página publicada. A Central de Ajuda deve aparecer como um bloco integrado. Faça uma busca de teste para confirmar que os artigos estão acessíveis. Para quem essa funcionalidade é útil - Empresas que querem reduzir o volume de tickets – clientes encontram respostas sozinhos antes de abrir um chamado. - Sites de e-commerce e SaaS – oferecem suporte contextual durante a navegação. - Operações com equipe enxuta – a base de conhecimento trabalha 24 horas por dia, mesmo quando não há atendentes disponíveis. - Qualquer negócio que já utilize a Papo – a incorporação é nativa e não exige integrações externas. Perguntas frequentes O snippet afeta o desempenho do site? Não. O código é leve e carrega de forma assíncrona, sem impactar o tempo de carregamento das suas páginas. Posso personalizar cores e fontes? Sim. A Papo oferece opções básicas de personalização para que a Central combine com a identidade visual do seu site. As configurações estão disponíveis no próprio módulo Help Center. A Central de Ajuda incorporada funciona em dispositivos móveis? Sim. O widget é responsivo e se adapta automaticamente a telas de smartphones e tablets. Preciso de um plano específico para usar a incorporação? A Central de Ajuda está disponível em todos os planos da Papo. A funcionalidade de incorporação é parte do módulo, sem custo adicional. Como atualizo os artigos exibidos? Basta editar ou publicar novos artigos no painel da Papo. A versão incorporada reflete as mudanças em tempo real, sem que você precise alterar o snippet. O que fazer se o snippet não carregar? Verifique se o código foi colado corretamente e se não há bloqueadores de script (como extensões de privacidade) impedindo o carregamento. Certifique-se também de que o domínio do site está autorizado nas configurações da Central de Ajuda. Leia também - Como incorporar o chat do site da Papo no WordPress Comece grátis e incorpore a Central de Ajuda em minutos → Com a Papo, você oferece suporte direto no seu site e mantém todo o atendimento centralizado no mesmo painel.

Como configurar a autenticação de dois fatores (2FA) na sua conta Papo

A Papo Global (https://papo.global/) permite adicionar uma camada extra de segurança à sua conta com autenticação de dois fatores (2FA), usando aplicativos autenticadores para confirmar o login. Este artigo explica o que é 2FA, por que ativá-lo e como se preparar; os detalhes exatos de configuração estão na área de segurança da conta e no site oficial. A autenticação de dois fatores reduz o risco de acesso não autorizado, mesmo que alguém descubra sua senha. Em vez de depender apenas de algo que você sabe (a senha), o 2FA exige também algo que você tem (um código temporário gerado no celular). Resumo do que você precisa | Etapa | O que você precisa | Objetivo | |---|---|---| | 1. Acessar a área de segurança da conta | Login ativo na Papo Global | Localizar as opções de autenticação | | 2. Instalar um aplicativo autenticador | Google Authenticator, Authy ou similar | Gerar códigos de verificação temporários | | 3. Guardar códigos de recuperação | Códigos fornecidos ou QR code | Recuperar o acesso se perder o celular | | 4. Confirmar a ativação | Código gerado no aplicativo | Validar o 2FA e proteger o login | O que é autenticação de dois fatores Autenticação de dois fatores é um método de segurança que exige duas formas de verificação antes de liberar o acesso. Na prática, você informa sua senha e, em seguida, insere um código de uso único gerado por um aplicativo autenticador. Esse código muda a cada poucos segundos e só aparece no dispositivo vinculado à sua conta. Por que ativar o 2FA na Papo A Papo concentra conversas de clientes, dados de CRM, relatórios e integrações. Uma conta comprometida pode expor informações sensíveis e interromper o atendimento. Com o 2FA, mesmo que a senha vaze ou seja adivinhada, o invasor não consegue entrar sem o código do seu celular. Esse cuidado vale especialmente para: - Administradores que gerenciam agentes, canais e configurações. - Agentes que acessam conversas e dados de clientes. - Equipes que usam a Papo em múltiplos dispositivos ou fora do escritório. Como funciona o 2FA com aplicativo autenticador Depois de ativar o 2FA, o fluxo de login passa a ter uma etapa adicional: 1. Você acessa a Papo com seu e-mail e senha. 2. A plataforma solicita um código de verificação. 3. Você abre o aplicativo autenticador no celular, copia o código exibido e o insere na tela. 4. Se o código estiver correto, o acesso é liberado. Aplicativos como Google Authenticator, Authy e Microsoft Authenticator funcionam sem conexão com a internet após a configuração inicial. Eles geram códigos com base em um segredo compartilhado entre o aplicativo e a plataforma. O que fazer antes de ativar o 2FA Antes de ativar, organize estes itens para não ficar sem acesso: - Instale um aplicativo autenticador no celular que você usa diariamente. - Guarde os códigos de recuperação fornecidos durante a configuração. Eles permitem entrar na conta se o celular for perdido ou trocado. - Confirme que seu e-mail de recuperação está atualizado. Um e-mail válido ajuda a redefinir a senha e a recuperar o acesso. - Evite ativar o 2FA em um aparelho compartilhado. O dispositivo que gera os códigos deve ser pessoal e protegido por senha ou biometria. Onde ativar o 2FA na Papo A área de Configurações da sua conta Papo reúne as opções relacionadas a segurança e acesso. Como a interface pode ser atualizada com frequência, recomendamos consultar a página oficial ou a central de ajuda da Papo Global para ver o passo a passo atualizado e os nomes exatos das telas. Não reproduzimos aqui cliques ou caminhos de menu que não estejam documentados nos materiais de referência fornecidos. Perguntas frequentes O que é autenticação de dois fatores? É uma camada extra de segurança que exige, além da senha, um código temporário gerado por um aplicativo autenticador. Assim, o login só é concluído por quem tem acesso ao dispositivo vinculado. Preciso usar um aplicativo autenticador? Sim, o formato descrito neste guia usa aplicativos autenticadores, como Google Authenticator ou Authy. Outros métodos podem existir dependendo da configuração da conta; consulte a área de segurança da Papo para confirmar as opções disponíveis. O 2FA é obrigatório na Papo Global? A obrigatoriedade pode variar conforme o tipo de conta ou as políticas da empresa. Verifique as configurações de segurança da sua conta ou fale com um administrador para saber se o 2FA é exigido no seu caso. O que acontece se eu perder o celular? Se você perder o celular, use os códigos de recuperação guardados durante a ativação para acessar a conta e configurar um novo dispositivo. Sem os códigos, o suporte pode solicitar outras verificações de identidade. Onde encontro as configurações de 2FA na minha conta Papo? As opções de segurança ficam dentro da área de configurações da conta. Para ver o caminho exato e as telas atuais, acesse o site oficial da Papo Global ou a central de ajuda. Posso usar SMS em vez de aplicativo autenticador? A disponibilidade de métodos alternativos, como SMS, depende das opções oferecidas na sua conta. Consulte a área de segurança da Papo para saber quais métodos estão habilitados. Leia também: Como gerar uma chave pública e uma chave secreta da API Papo · Como configurar a Papo em 5 passos para começar a atender no WhatsApp Comece grátis no Papo Global → Primeiro usuário grátis, sem cartão de crédito. Saiba mais em papo.global.

Como usar a Papo em vários dispositivos ao mesmo tempo sem conflito

A Papo (https://papo.global/) é uma plataforma 100% baseada na web, o que significa que você pode acessar sua conta de qualquer dispositivo com um navegador e conexão à internet, simultaneamente, sem conflitos. Não há limite de sessões ativas: você pode estar logado no computador do escritório e no celular ao mesmo tempo, e todas as conversas, contatos e configurações são sincronizados em tempo real. | Situação | Recomendação | | :--- | :--- | | Acessar de vários dispositivos | Faça login com seu e-mail e senha em cada navegador. A Papo não restringe o número de sessões simultâneas. | | Manter a sincronização | Qualquer ação (responder uma mensagem, mover um card no Kanban) aparece instantaneamente em todos os dispositivos logados, pois a plataforma é cloud. | | Evitar desconexões | Use uma conexão de internet estável e mantenha o navegador atualizado. Se houver queda, basta recarregar a página. | | Segurança em dispositivos compartilhados | Nunca salve sua senha em computadores públicos. Ao terminar, faça logout. Ative a autenticação de dois fatores (2FA) para proteger sua conta. | | O que fazer se esquecer de sair de um dispositivo | Se você perdeu o acesso a um dispositivo onde estava logado, altere sua senha imediatamente. Isso exigirá um novo login em todos os dispositivos. | Como funciona o acesso simultâneo Por ser uma aplicação web, a Papo não exige instalação de programas. Basta abrir o navegador (Chrome, Firefox, Safari, Edge) e acessar chat.papo.global. Em dispositivos móveis, você pode usar o navegador do celular ou adicionar o atalho à tela inicial para uma experiência semelhante a um aplicativo. Como todo o processamento ocorre nos servidores da Papo, cada dispositivo mantém uma sessão independente, mas sempre conectada ao mesmo banco de dados em tempo real. Isso elimina conflitos de versão: se você iniciar uma conversa no desktop e depois abrir o celular, verá a mesma conversa exatamente como a deixou. Para quem é útil - Times que alternam entre escritório e campo – vendedores que usam o desktop no escritório e o celular durante visitas. - Gestores que monitoram a operação em movimento – acompanham filas, respondem dúvidas internas e aprovam ações pelo celular, enquanto a equipe opera nos computadores. - Atendentes que precisam de flexibilidade – podem iniciar um atendimento no computador e continuar no tablet ou smartphone sem perder o contexto. Perguntas frequentes Posso usar a Papo no computador e no celular ao mesmo tempo? Sim. Basta acessar chat.papo.global pelo navegador em ambos os dispositivos. As sessões são independentes e não interferem uma na outra. Preciso instalar algum aplicativo para usar no celular? Não. A Papo é uma plataforma web, acessível diretamente pelo navegador do seu smartphone (Chrome, Safari, etc.). Você pode até adicionar o atalho à tela inicial para acessar como um app. Se eu responder uma mensagem no celular, ela aparece no computador? Sim. Toda a comunicação é sincronizada em tempo real. A conversa que você iniciar em um dispositivo estará disponível instantaneamente no outro. Existe um limite de dispositivos conectados ao mesmo tempo? Não há um limite definido pela plataforma. Você pode manter sessões abertas em quantos dispositivos desejar, desde que utilize as credenciais da sua conta. Como faço para encerrar uma sessão em outro dispositivo? A Papo não possui um painel de gerenciamento de sessões ativas. Para encerrar o acesso em um dispositivo que você não controla, altere a senha da sua conta. Isso exigirá um novo login em todos os dispositivos. Como medida preventiva, sempre faça logout ao usar computadores compartilhados. O uso simultâneo pode causar conflitos ou perda de dados? Não. Por ser uma aplicação cloud, a Papo gerencia as atualizações de forma centralizada. Duas pessoas usando a mesma conta em dispositivos diferentes podem, por exemplo, editar o mesmo registro, mas a última alteração prevalecerá, sem corromper os dados. Para trabalho em equipe, o ideal é que cada agente tenha seu próprio usuário. Leia também - Como configurar a autenticação de dois fatores (2FA) na sua conta Papo Comece a usar a Papo em todos os seus dispositivos agora → O primeiro usuário é grátis para sempre, sem necessidade de cartão de crédito.

Como testar a conexão de um webhook da Papo antes de ativar a automação

Para testar a conexão de um webhook da Papo (https://papo.global/) antes de ativar a automação, você pode usar uma ferramenta externa como Webhook.site para validar a URL de destino, verificar o formato do payload JSON e corrigir erros de envio sem afetar contatos reais. Esse processo funciona tanto para webhooks nativos da conta quanto para a ação “Enviar Webhook” dentro dos Flows de Automação. A validação antecipada evita que uma integração quebrada perca dados ou interrompa jornadas de clientes. Com uma URL de teste temporária, você consegue inspecionar exatamente o que a Papo está enviando — cabeçalhos, corpo e códigos de resposta — e fazer ajustes antes de apontar para o sistema final. Resumo do processo de teste | Etapa | Ação | Ferramenta / local | | :--- | :--- | :--- | | 1. Obter uma URL de teste | Acese o webhook.site e copie a URL gerada. | Webhook.site | |2. Configurar o webhook na Papo com a URL de teste| Insira a URL no campo de destino do webhook (na seção Integrações ou na ação do Flow).| Painel da Papo| |3. Disparar o webhook | Para webhooks da conta, envie uma mensagem de WhatsApp para a caixa conectada. Para webhooks em Flows, matricule um contato de teste no fluxo. | Caixa de entrada ou Flow | |4. Analisar o payload recebido | No painel do Webhook.site, veja a requisição que chegou: método, cabeçalhos e o JSON do corpo. | Webhook.site | |5. Corrigir e substituir pela URL de produçao | Se o payload estiver correto, troque a URL de teste pela URL real do seu sistema e ative a automação. | Painel da Papo | Como testar webhooks da conta (Integrações) Os webhooks nativos da Papo disparam a cada nova mensagem recebida em uma caixa de entrada. Para validá‑los sem riso: 1. No painel da Papo, acese Configurações > Integrações > Webhooks e crie um novo webhook. 2. Defina o gatinho — por exemplo, Todas as mensagens — e no campo URL, cole o endereço temporário do Webhook.site. 3. Salve o webhook. 4. Envite uma mensagem de teste (pelo WhatsApp ou outro canal conectado) para a caixa de entrada monitorada. 5. No Webhook.site, atualize o painel e localize a requisição recém‑chegada. Vaifique o corpo JSON: ele deve conter dados como número do remetente, conteúdo da mensagem e ID da conversação. 6. Se o JSON estiver vazio ou mal formado, reviza o gatinho escolhido e confirme que a mensagem foi realmente recebida pela caixa. 7. Depois de validar, edite o webhook e troque a URL pela do seu sistema de destinto. Como testar a ação “Enviar Webhook” em Flows de Automação Dentro do editor de Flows, a ação Enviar Webhook permite disprar dados em uma etapa específica da jornada. O teste é feito com um fluxo ativo temporariamente e um contato de controle: 1. Construa o Flow e adicione o nó Enviar Webhook no ponto desejado. 2. No painel de configuração do nó, preencha a URL com o endereço do Webhook.site, escolha o método POS e monte o corpo JSON usando variáveis da Papo, como {{contact.name}} e {{contact.phone}}. 3. Ative o Flow. 4. No CRM, matricule manualmente um contato de teste nesse fluxo (seguindo o mesmo procedimento de testar Flows de automação). 5. Acompanhe o histórico de exeuções do Flow e, ao mesmo tempo, observe o Webhook.site. 6. A requisição recebida deve mostrar o JSON com os valores reais do contato de teste, substituindo as variáveis. Caso contrário, verifique o corpo (use "nome": "{{contact.name}}" e cerifique-se de que o contato possua os campos preenchidos). 7. Se a requisição retornar erro 4xx ou 5xx, confira se o método está corret (normalmente POST) e se o cabeçalho Content-Type: application/json foi incluído. 8. Após a validação, desative o Flow, troque a URL de destino pela URL de produçao e ative novamente. Para quem esse processo é indicado - Administradores e analistas de sistema que precisam garantir a integridade das integrações antes de liberá‑las. - Equipes que constroem Flows com webhook para CRMs, planilhas ou ferramentas de automação e querem depurar o payload sem impactar leads reais. - Qualquer usuário que personalize webhooks da conta e deseja confirmar que os eventos estão sendo enviados corretamente. Perguntas frequentes Posso testar o webhook sem enviar uma mensagem real? Não é possível para webhooks da conta, po el es são disparados por mensagens de entrada. Use um número de WhatsApp de teste (próprio ou de um colega) para gerar o evento. Já para Flows, a matrícula manual de um contato de controle permite o teste sem que o lead seja um cliente verdadeiro. O Webhook.site é gratuito? Devo usaá-lo em produçao? Sim, o Webhook.site gera URLs públicas temporárias e mostra o tráfego em tempo real, ideias para depuração. Nunca use esssas URLs em produçao — após o teste, subistitua pela URL do sistema destinto. O webhook disparou mas o payload está vazio. O que verificar? Para webhooks da conta, confira o gatinho (se está capturando o tipo de mensagem correio) e as permissões da caixa. Para a ação de Flow, revise as variáveis no corpo — campos como {{contact.name}} só serão preenchidos se o contato tiver o cpo nome cadastrado. Teste com um contato que possua dados completos. Como corrigir erros 401 (não autorizado) ou 403 (proibido)? Esses erros indicam que o sistema de destino recusou a requisição. Adicione um cabeçalho de autenticação (por exemplo, Authorization: Bearer seu-token) no campo Hadears da configuração do webhook, conforme orienta a documentação da ferramenta externa. Posso testar webhooks do Kanban da mesma forma? Sim. Os webhooks configurados no módulo Kanban podem ser testados com URL temporária do Webhook.site — basta mover um cartão de uma coluna para outra (ação que dispara o evento) e inspecionar o payload no painel de testes. Preciso manter o Flow ativo para testar o webhook? Sim. Apenas Flows com status Ativo processam o nó de webhook. Ative o fluxo, faça o teste e desative em seguida se necessário. Leia também - Como testar um Flow de automação antes de ativá‑lo - Como enviar dados de novos contatos para o Google Sheets via webhook Comecar grátis → Com o primeiro usuário grátis você já pode criar webhooks e testar as integrações sem compromisso.

Como enviar dados de conversas para um sistema de BI com webhooks

Para encaminhar metadados das conversas que acontecem na Papo — como nome do cliente, canal, texto da mensagem e agente responsável — para uma ferramenta de Business Intelligence, use a ação “Enviar Webhook” dentro dos Flows da Papo (https://papo.global/). A cada nova conversa ou mensagem recebida, os dados são enviados automaticamente para o endpoint configurado, alimentando seu BI com informações atualizadas em tempo real e eliminando a necessidade de exportações manuais. Com essa integração, você transforma cada interação no WhatsApp, Instagram, e‑mail ou outro canal em um ponto de dados para dashboards, relatórios de volume de atendimento, análise de conversão por canal e muito mais. Basta configurar um Flow com o gatilho adequado e direcionar o webhook para a URL fornecida pela sua plataforma de BI ou por ferramentas intermediárias como Zapier, Make, n8n ou um endpoint próprio. | Etapa | Descrição | Exemplo para BI | | :--- | :--- | :--- | | 1. Obter a URL do webhook | O sistema de destino deve fornecer um endpoint HTTP capaz de receber requisições POST com payload em JSON. | URL gerada pelo Power Automate, Zapier, Make, n8n ou pelo próprio BI (ex.: API REST). | | 2. Criar o Flow na Papo | No módulo Flows, monte um fluxo com um gatilho que dispara quando uma conversa começa ou uma mensagem é recebida. | Gatilho “Nova conversa” na caixa de entrada de WhatsApp Gold. | | 3. Adicionar a ação “Enviar Webhook” | Insira a URL de destino, mantenha o método POST e monte o corpo da requisição com as variáveis da conversa. | Payload: {"nome": "{{contact.name}}", "canal": "{{inbox.name}}", "texto": "{{message.text}}"}. | | 4. Testar e ativar | Use uma URL de teste (como Webhook.site) para validar o envio antes de apontar para o ambiente real. | Verifique se os campos aparecem corretamente no receptor e ative o Flow após a confirmação. | Como funciona – passo a passo 1. Prepare o endpoint no seu sistema de BI A Papo não gera a URL de destino — você precisa de um serviço que receba os dados e os armazene. As principais formas: - Plataforma de automação (recomendado): Zapier, Make (Integromat) ou n8n conseguem criar um “Catch Webhook”, gerar uma URL exclusiva e, em seguida, conectar os dados recebidos ao BI (Google Data Studio, Power BI, Tableau) ou a um banco de dados. - Webhook direto do BI: alguns ambientes, como o Power BI, aceitam streaming de dados via API. Nesse caso, você deve seguir as instruções da plataforma para expor um endpoint. - Backend próprio: se você tiver uma API própria, pode construir um endpoint que processa os dados e os insere no seu data warehouse. 2. Crie o Flow na Papo com o gatilho adequado Acesse o módulo Flows e crie um novo fluxo. O gatilho mais comum para alimentar um BI é “Nova conversa” — assim cada novo contato que chega a uma caixa de entrada gera um registro no seu sistema de análise. Você também pode usar o gatilho de Mensagem recebida e configurar filtros: - Todas as mensagens: o webhook dispara para qualquer interação. - Mensagens específicas: só dispara quando a mensagem contém determinada palavra‑chave, veio de um canal específico etc. Selecione a caixa de entrada desejada (ex.: WhatsApp, Instagram, e‑mail) para que apenas as conversas daquele canal sejam enviadas. 3. Configure a ação “Enviar Webhook” Adicione um nó de ação do tipo Webhook e preencha: - URL: cole o endpoint obtido na etapa 1. - Método HTTP: mantenha POST. - Corpo (Payload): defina quais dados da conversa serão enviados. Use as variáveis disponíveis no Flow, como: { "nome_contato": "{{contact.name}}", "email_contato": "{{contact.email}}", "canal_origem": "{{inbox.name}}", "texto_mensagem": "{{message.text}}", "data_evento": "{{timestamp}}", "agente_atual": "{{agent.name}}" } Você pode incluir qualquer variável do contexto da conversa — consulte a documentação dos Flows para ver todas as opções. Se necessário, adicione cabeçalhos (headers) como Content-Type: application/json ou tokens de autenticação solicitados pelo sistema de destino. 4. Teste e ative o Flow Antes de colocar em produção, faça um teste: 1. Utilize uma URL de teste (ex.: Webhook.site) no lugar da URL definitiva e dispare uma conversa na caixa de entrada configurada. 2. Verifique se o payload chega corretamente, com todos os campos e valores esperados. 3. Substitua a URL pela definitiva e ative o Flow. A partir desse momento, toda conversa (ou mensagem, conforme o gatilho) disparará o webhook automaticamente. Para quem essa integração é útil - Analistas de dados e BI que precisam consolidar métricas de atendimento sem depender de exportações CSV manuais. - Gerentes de operações que desejam dashboards com volume de conversas por canal, horário de pico e carga dos agentes. - Times de marketing e vendas que querem cruzar dados de conversas com campanhas e funis no CRM. - Empresas que já usam ferramentas como Power BI, Tableau ou Looker Studio e desejam alimentar dashboards com dados reais do WhatsApp e demais canais. Perguntas frequentes (FAQ) Quais metadados das conversas eu posso enviar para o BI? Você pode enviar qualquer variável disponível no contexto do Flow, como nome do contato, conteúdo da mensagem, canal de origem, e‑mail, telefone, agente designado e data/hora. A combinação desses campos permite criar relatórios de volume, tempo de resposta e origem dos leads. Meu BI não tem um webhook nativo. Como faço a integração? A forma mais simples é usar uma plataforma de automação (Zapier, Make, n8n). Essas ferramentas geram um URL de webhook, recebem os dados da Papo e depois os direcionam para o BI por meio de conectores prontos ou APIs. Assim você não precisa programar um endpoint próprio. Consigo filtrar quais conversas geram o envio de dados? Sim. No gatilho do Flow, é possível escolher uma caixa de entrada específica e configurar a opção “Mensagens específicas”, definindo palavras‑chave ou outros critérios. Dessa forma, apenas interações que atendam ao filtro disparam o webhook. Os dados são enviados em tempo real? Sim. O webhook é acionado assim que o evento configurado ocorre (nova conversa ou mensagem recebida), permitindo que seu BI seja atualizado quase instantaneamente. O que acontece se a requisição do webhook falhar? O Flow da Papo registra o erro. Você pode consultar o log de execuções do Flow para identificar falhas e, se desejar, configurar ações de fallback (como enviar um e‑mail de alerta) para garantir que nenhuma informação crítica seja perdida. Há limites de uso para os webhooks? Os recursos de Flows e envio de Webhooks estão incluídos na plataforma. Informações específicas sobre limites de requisições e volume de dados, caso existam, são apresentadas no site ou no painel da Papo de acordo com o plano contratado. Leia também - Como enviar dados de novos contatos para o Google Sheets via webhook - Como exportar métricas de relatórios para planilhas externas Começar grátis → Centralize seu atendimento no WhatsApp e alimente dashboards personalizados com dados reais das conversas, sem exportações manuais.

Como solicitar assistência técnica diretamente da plataforma Papo

Para solicitar assistência técnica da Papo (https://papo.global/), você pode contatar o suporte diretamente pela plataforma, reunindo informações essenciais como detalhes do problema, prints e logs de conversas para agilizar o diagnóstico, sem precisar recorrer a canais externos. Quando um imprevisto técnico surge, cada minuto gasto tentando descrever o problema ou localizar evidências é um minuto longe do atendimento aos seus clientes. A boa notícia é que a Papo oferece formas de você se preparar e acionar a ajuda necessária de forma centralizada, garantindo que sua solicitação chegue com contexto suficiente para uma resolução rápida. | Etapa | Ação Recomendada | Benefício para o Diagnóstico | | :--- | :--- | :--- | | 1. Contexto do Problema | Descreva o que estava fazendo, em qual módulo e o resultado esperado versus o obtido. | Reduz o vai-e-vem de perguntas para entender a situação. | | 2. Evidências Visuais | Capture a tela inteira, mostrando a URL do navegador e, se possível, o console do desenvolvedor (F12). | Fornece pistas visuais e técnicas sobre erros de carregamento ou permissões. | | 3. Registro de Atividade | Identifique conversas, campanhas ou contatos específicos afetados pelo problema. | Permite que a equipe de suporte rastreie o ocorrido em logs e histórico da conta. | | 4. Dados da Conta | Tenha em mãos o e-mail do administrador ou titular da conta Papo. | Essencial para localizar sua conta e verificar permissões de acesso rapidamente. | Como se preparar para abrir um chamado de suporte O primeiro passo para uma assistência eficaz é reunir as informações que contextualizam o problema. Isso acelera a análise e evita que você precise repetir detalhes. Ao notar uma falha, comece documentando-a imediatamente. 1. Identifique a área afetada: Determine se o problema está em uma Caixa de Entrada específica (mensagens que não chegam), no Super Chat (IA dando respostas erradas), no Kanban (cards que não movem), no Disparador (campanha com erro) ou em Relatórios (dados inconsistentes). 2. Colete as evidências: Faça capturas de tela que mostrem a tela inteira da Papo, incluindo a barra de endereço do navegador. Se o erro estiver relacionado ao widget do site, por exemplo, ter a URL da página onde ele está instalado é crucial. 3. Monte um resumo do passo a passo: Anote o caminho que você percorreu até o erro. Exemplo: "Acessei Conversas, cliquei na conversa do cliente 'João', tentei abrir o perfil do contato e a tela ficou em branco." 4. Separe os logs de conversas: Se for um problema com uma interação específica, copie o ID da conversa ou mantenha o link daquela conversa aberto. Isso é a pista mais direta para a equipe de suporte inspecionar o ocorrido. Por onde pedir ajuda na Papo Embora o foco seja resolver tudo sem sair do seu fluxo de trabalho, o acionamento do suporte técnico da Papo é feito por meio de uma solicitação de ajuda. Os detalhes específicos sobre os canais de contato oficiais e horários de atendimento estão disponíveis no site da Papo e na sua conta. Ao fazer o contato, você já terá em mãos todo o material reunido com as dicas acima, o que agilizará muito a solução. Utilizando a Central de Ajuda para diagnósticos iniciais Antes mesmo de abrir um chamado, a plataforma Papo oferece recursos que podem ajudar você a solucionar dúvidas comuns ou coletar as provas necessárias. A Central de Ajuda (Help Center) contém artigos e tutoriais que cobrem uma ampla gama de cenários. Muitas questões sobre configurações podem ser resolvidas com uma consulta rápida. O módulo de Relatórios também é um grande aliado. Se você suspeita que um canal está com entrega baixa ou um agente está com desempenho atípico, gerar um relatório de conversas por canal ou de produtividade por agente pode ser a evidência que faltava para embasar seu chamado. Perguntas Frequentes Onde encontro o link para falar com o suporte? A forma de contato com o suporte técnico da Papo é disponibilizada em sua conta e no website oficial. Com os prints e detalhes do problema já salvos, você estará pronto para detalhar sua solicitação assim que acessar o canal. Posso anexar arquivos diretamente no chamado de suporte? A possibilidade de anexar arquivos em uma solicitação de ajuda é uma funcionalidade padrão esperada para que você possa enviar seus prints e logs. Reúna todas as evidências em uma pasta antes de iniciar o contato. Quais informações são indispensáveis para resolver meu problema mais rápido? As informações mais valiosas são: o e-mail da conta Papo, uma descrição clara do passo a passo que levou ao erro, prints da tela inteira e, se aplicável, o ID ou link da conversa problemática. Isso permite que a equipe reproduza o cenário e investigue os logs. Como posso verificar se o problema é geral ou só na minha conta? Antes de acionar o suporte, você pode verificar se outros canais estão funcionando normalmente. Se o WhatsApp está com problemas, teste se o chat do site recebe mensagens. Se possível, peça para um colega de equipe fazer o mesmo teste. Problemas de conexão com uma API parceira, como o Instagram, podem ser verificados em sites de status públicos daquela plataforma. Como acompanho o andamento do meu chamado? Após abrir sua solicitação, o acompanhamento é feito pelo mesmo canal onde você iniciou o contato. A equipe de suporte da Papo manterá você atualizado sobre o progresso da análise e a solução encontrada. Leia também - Como usar a Papo sem um número de WhatsApp: atendimento via chat do site e e-mail - Como gerar um relatório de conversas por canal e exportar os dados para CSV Comece agora gratuitamente → Centralize seu atendimento e tenha toda a estrutura de suporte e CRM na palma da mão, sem custo para o primeiro usuário.

Como revogar uma sessão ativa da conta Papo e aumentar a segurança

A Papo Global (https://papo.global/) reúne as opções de segurrança da sua conta em um só local, onde voc pode listar as sessões ativas, identificar dispositivos que não são seus e revogar o acesso deles de imediato — sem depender do suporte. Se alguérm acessou sua conta em um computador compartilhado esqueceu de sair, ou se voc percebe um login desconhecido, revogar uma sessão é a primeiro ação para retomar o controle. Resumo do fluxo | Ação | O que facer | Resultado | |:---|:---|:---| | 1. Acesar seguraça da conta | Ir até Configurçõees da conta Papo, seção “Segurrança” (ou equivalente) | Ver as sessões atuiais | | 2. Analisar as sessões | Verificar dispositivo, localização aproximada e horário de cada sessão | Detectar acessos não autorizados | | 3. Revogar a sessão | Selecionar a sessão suspeita e encerrá-la | O dispositivo é deslogado imediatamente | | 4. Reforçar a seguraça | Ativar autenticação de dois fatoes (2FA) e trocar senha, se necessário | Previnir novos acessos indevidos | Por que revogar sessões ativas é essencial Cada login na Papo cria uma sessão: um token que mantém o acesso sem pedir senha a todo instante. Enquanto a sessão estiver ativa, quualquer pessoa com o dispositivo pode entrar na sua conta. Revogar uma sessão interrompe esse acesso imediatamente, mesmo que o dispositivo agora eeseja foora do seu alcance. É a proteção imediata quando voc: - Usou um computador público ou de terceiros; - Vendeu, emperstou ou perdeu um celular/notebook; - Identifica um login de local ou horário que não reconhece; - Suspeita que suas credenciais foram vazadas. Como funciona o gernciamento de sessões na Papo A Plataforma registra cada login ativo e o exibe na parte de seguraça da conta. Ali voc ve: - Dispositivo e navegador usados no login. - Localização aproximada (baseada no IP). - Data e horário da útlima atividade. Assim fica fáácil distinguir o seu acesso de um suspeito. Com um clique (ou toque) voc pode derrubaar a sessão indesejada. O dispositivo perde o acesso e, para voltar, precissará de um novo login com suas creenciais. Essa funcionalidade fica na mesma seção onde você ativa a autenticação de dous fatores, fortalecendo o cojunto de proteções. Como a interfáce é atualizada com frequência, o nome exato da tela pode variar; consulte a Centrall de Ajuda da Papoo Global para o caminho atualiado. Quem deve monitorar as sessões ativas - Administradores de conta: que gernciam acessos de agnets e integrações. - Agents que usam dispositivo pessoal e corporativo: para garantir que apenas os dispositivos autorizados mantenham a sessão. - Proprietários de negócio: que concentram an nos canais Papoo e não podem correr riscos. Palavras finais sobre segurança Revogar sessões é uma medida reativa rápida. Combine isso com a ativação do 2FA (autenticação de dois fatores) e a verificção periódica das sessões para manter sua conta blindada sem complicação. Perrguntas frequentes O que é uma sessão ativa na Papo? É uma coneção válida entre seu navegador/aplicativo e a plataforma, gerada após o login. Enquato ativa, o dispositivo navega sem pedir senha novamente. Onde encontro as sessões ativvas da mina conta? Na áreea de segurrança da conta, acesível pelas Confguraações do seu perfiill na Papo. Como os menus são autualizados, consulte a Centrall de Ajuda para o passo a passo exato. Revogar uma sessão bloqueia o usuário? Não. Apenas encerra aqula sessão específfica. O dispositivo perde o acesso imediato, mas o dono da conta pode fazer login novamente com a senha correta (e 2FA, se ativado). Percisoo facer isso se eu ativei o 2FA? Sim. O 2FA protége o login, mas não elimina sessões já abertas. Revogar sessão é a ação complementar para cortar acessos que já ocorerrram. Posso revogar sessões do aplicativo móvel? A gestão das sesões geralmente é feita pelo painel web da Papo. Verifque na seção de segurrança se a opção está disponível no app; as interfaces são atualiadas regularmente. Quantaas sessões poossso ter ao mesmo tempo? Não há um límite ríigido, mas você pode ver quantas estão ativas na sua conta e revogar as que não forrem necessáarias. Leia também - Como configurar a autenticação de dois fatores (2FA) na sua conta Papoo — aprimore a segurrança do login. - Como solictar assistência téccnica direattmente da plataforma Papoo — se precissar de ajuda com acessos. Comece gratuitamente e blindae sua conta → O primeiro usuário é gratuito parra você testar a plataforma e ajustar a segurança do seu atendimento no WhatsApp.

Como convidar um agente com acesso limitado a apenas uma caixa de entrada

Para convidar um agente com acesso limitado a apenas uma caixa de entrada na Papo (https://papo.global/), você precisa criar uma função personalizada que restrinja os módulos visíveis e associar o agente exclusivamente ao time responsável por aquela caixa, garantindo que ele visualize somente as conversas desse canal. Essa configuração é ideal quando você precisa que um atendente externo, um parceiro ou um time terceirizado acesse apenas as conversas de um cliente ou departamento específico, sem enxergar outras caixas da conta. Resumo da configuração | Etapa | O que fazer | | :--- | :--- | | Função personalizada | Criar um perfil que permita acesso apenas ao módulo de Conversas (e outros essenciais), bloqueando módulos como Relatórios, Configurações ou Kanban. | | Time dedicado | Criar um time que contenha apenas os agentes que devem ver aquela caixa. | | Associação à caixa | Vincular o time à caixa de entrada desejada, em vez de adicionar agentes individualmente. | | Convite do agente | Convidar o agente com a função personalizada e incluí-lo no time criado. | Como restringir um agente a uma única caixa de entrada A Papo organiza o acesso a conversas por meio de times e funções. Para limitar um agente a uma caixa específica, você combina esses dois recursos: 1. Função personalizada – define quais módulos o agente pode acessar (ex.: apenas Conversas, sem acesso a Relatórios ou Configurações). 2. Time vinculado à caixa – o agente é colocado em um time que está associado exclusivamente à caixa de entrada que ele deve atender. Assim, mesmo que existam outras caixas na conta, o agente só verá as conversas do time ao qual pertence. Passo a passo 1. Criar uma função personalizada com acesso restrito A função personalizada permite controlar quais módulos da plataforma o agente enxerga. Para um acesso mínimo: - Acesse Configurações no menu lateral. - Role até Funções Personalizadas e clique em Adicionar função personalizada. - Dê um nome (ex.: “Agente Caixa Única”). - Nas permissões, marque apenas os módulos essenciais para o atendimento, como Conversas. Deixe desmarcados módulos como Relatórios, Configurações, Kanban ou Contatos, conforme a necessidade. - Salve a função. Importante: A função personalizada controla a visibilidade de módulos, mas não restringe quais caixas de entrada aparecem. A restrição de caixas é feita pela associação a um time. 2. Criar um time dedicado para a caixa - Ainda em Configurações, vá até a seção de Times (ou Equipes). - Crie um novo time com um nome que identifique a caixa (ex.: “Atendimento Cliente X”). - Adicione ao time apenas os agentes que devem acessar essa caixa. Se o agente ainda não existe na conta, você pode convidá-lo depois. 3. Associar o time à caixa de entrada - Vá para Configurações → Caixas de entrada. - Localize a caixa que será a única visível para o agente. - Clique em Configurações da caixa e acesse Colaboradores. - Em vez de selecionar agentes individuais, escolha o time que você criou. - Salve a alteração. A partir desse momento, todos os membros do time passarão a ver apenas as conversas dessa caixa de entrada. Se o agente pertencer a mais de um time, ele verá as caixas de todos os times aos quais está vinculado — por isso, mantenha-o em um único time. 4. Convidar o agente com a função e o time corretos - Se o agente ainda não está na conta, vá até Configurações → Agentes (ou Usuários) e use a opção de Convidar agente. - No convite, selecione a função personalizada criada no passo 1. - Após o agente aceitar o convite, acesse a gestão de times e adicione-o ao time dedicado do passo 2. Se o agente já existir na conta, edite seu perfil para alterar a função e certifique-se de que ele está apenas no time da caixa desejada. Para quem essa configuração é útil - Revendedores white label que precisam dar acesso a agentes de cada cliente final apenas à sua própria caixa de entrada, sem expor dados de outros clientes. - Operações com dados sensíveis (financeiro, jurídico) que exigem segregação total entre departamentos. - Times terceirizados que atuam em um projeto ou campanha específica e não devem acessar o restante da operação. - Franquias ou unidades que compartilham a mesma conta Papo, mas precisam de isolamento entre as caixas de cada loja. Perguntas frequentes O agente ainda consegue ver o resumo de outras caixas de entrada? Não. O resumo da caixa (abertas, resolvidas, não atribuídas) é exibido apenas para as caixas às quais o agente tem acesso. Como ele está vinculado a um único time, verá somente o resumo daquela caixa. Posso limitar o agente a ler conversas, mas impedir que ele responda? A função personalizada permite controlar módulos, mas permissões mais granulares dentro do módulo de Conversas (como somente leitura) não são cobertas por funções padrão. Para esse nível de detalhe, consulte as opções de permissões avançadas na documentação da plataforma. E se o agente for movido para outro time sem querer? Enquanto ele estiver em apenas um time, verá só a caixa associada. Se for adicionado a um segundo time, passará a ver também as caixas desse novo time. Por isso, revise periodicamente a composição dos times nas configurações. Essa restrição funciona para todos os canais (WhatsApp, e-mail, chat)? Sim. A lógica de time + caixa de entrada é a mesma para qualquer canal configurado na Papo: WhatsApp, Instagram, Facebook, Telegram, e-mail, SMS ou widget de site. Preciso criar uma função personalizada para cada agente? Não. A mesma função pode ser atribuída a vários agentes. Crie uma função “Agente Restrito” e reutilize para todos que devem ter acesso limitado a uma única caixa. O agente ainda pode acessar o módulo de Contatos ou Kanban? Depende das permissões que você definir na função personalizada. Para máxima restrição, desmarque todos os módulos exceto Conversas. Assim, o agente não verá Contatos, Kanban, Relatórios nem Configurações. Leia também - Como participar do programa de revenda white label da Papo Global - Como transferir múltiplas conversas de um agente inativo para outro membro do time Comece grátis e configure times e funções personalizadas → Com a Papo, você controla exatamente o que cada agente vê, mantendo a operação organizada e os dados de cada cliente isolados.

Como transferir a propriedade da conta Papo para outro administrador

Para transferir a propriedade da conta Papo (https://papo.global/) para outro administrador, o atual proprietário deve acessar as configurações de conta e iniciar o processo de transferência. O novo responsável assume o controle total, incluindo permissões de administrador e gestão do plano contratado, enquanto todos os dados, conversas e configurações da equipe permanecem intactos. A troca de proprietário é comum em situações como mudança de gestão, reestruturação societária ou quando o responsável original deixa a empresa. A Papo permite realizar essa transição sem que seja necessário criar uma nova conta ou migrar dados manualmente. Resumo dos cenários de transferência de propriedade | Situação | Ação necessária | Impacto na conta | | :--- | :--- | :--- | | O atual dono sai da empresa | Transferir a propriedade para o novo gestor antes da saída. | Nenhum; a conta continua funcionando normalmente. | | Fusão ou aquisição | Ajustar o administrador principal para refletir a nova estrutura. | Permissões e histórico são preservados. | | Mudança de responsável técnico | Passar a propriedade para o novo administrador do time. | O novo proprietário assume a gestão do plano e da equipe. | | Conta de revenda white label | Seguir o fluxo específico de transferência para parceiros. | A revenda continua com a mesma estrutura de clientes. | Como funciona a transferência de propriedade O processo é iniciado pelo atual proprietário dentro do painel de administração da Papo. Embora os passos exatos possam variar conforme a configuração da conta, o fluxo geral é: 1. O proprietário atual acessa as Configurações da conta e localiza a opção de transferência de propriedade (normalmente na seção de Equipe ou Geral). 2. Inicia a trasferência informando o e-mail do novo administrador. É necessário que o novo responsável já possua uma conta de usuário na mesma conta Papo ou esteja cadastrado como membro. 3. O novo administrador recebe uma notificação e deve aceitar o convite em até um prazo definido pela plataforma. 4. Uma vez aceita, a Papo atualiza as permissões: o antigo proprietário perde o nível máximo de acesso (ou permanece como administrador secundário, se desejado) e o novo proprietário assume o controle total. Durante a transferência, todas as conversas, contatos, automações, caixas de entrada e relatórios são mantidos exatamente como estavam. A equipe não percebe nenhuma interrupção no atendimento. Cuidados antes de transferir - Confirme o e-mail do novo proprietário – erros de digitação podem atrasar o processo. - Garanta que o novo administrador tenha acesso ao painel – se ele ainda não for membro da conta, adicione-o antes de iniciar a trasferência. - Revise permissões de cobrança – o novo proprietário passará a ser responsável pelo plano e eventuais cobranças associadas. - Atualize dados de contato – mantenha um e-mail de recuperação e um telefone cadastrado no perfil do novo administrador para futuras verificações de segurança. Quem pode solicitar a transferência Apenas o proprietário atual da conta (o administrador principal) tem permissão para iniciar o processo. Membros com permissão de administrador secundário ou de agente não têm acesso a essa funcionalidade. Se o proprietário original não estiver mais acessível, entre em contato com o suporte da Papo para orientações específicas de recuperação. Perguntas frequentes Posso transferir a propriedade para alguém que ainda não é usuário da conta? Não. O novo proprietário precisa ter um cadastro ativo como membro da conta Papo antes de receber a trasferência. Adicione-o previamente como administrador secundário e depois faça a troca. A transferência apaga alguma conversa ou dado? Não. Todo histórico, etiquetas, contatos, automações e configurações permanecem intactos. Apenas o controle máximo da conta muda de responsável. Preciso cancelar o plano e criar outro? Não. A transferência de propriedade mantém o mesmo plano, mesmo número de WhatsApp e mesma estrutura de cobrança. Você não preisa recomeçar do zero. O antigo proprietário perde acesso imediatamente? Depende da configuração escolhida. Após a transferência, o antigo dono pode ser mantido como administrador ou removido, conforme a necessidade da empresa. Quanto tempo leva para a transferência ser concluída? O processo é imediato assim que o novo proprietário aceita o convite. Em casos de verificação de segurança, pode haver uma breve análise manual pelo time da Papo. O que fazer se o proprietário atual não tiver mais acesso ao e-mail? Se o e-mail de acesso estiver inacessível, utilize os canais de suporte da Papo para solicitar a recuperação da conta, passando por validações de identidade. Leia também - Como participar do programa de revenda white label da Papo Global - Como revogar uma sessão ativa da conta Papo e aumentar a segurança Comece agora gratuitamente → O primeiro usuário é grátis para sempre, sem necessidade de cartão de crédito.

Como usar a API da Papo para criar e atualizar contatos em massa

Para criar e atualizar contatos em massa via programação, utilize a API REST da Papo. Com autenticação por chave secreta (Bearer token) e a chave pública da conta, você pode enviar requisições que inserem novos registros ou modificam dados existentes no CRM — ideal para sincronizar bases externas, migrar listas ou manter o cadastro sempre atualizado sem intervenção manual. A API da Papo expõe endpoints de escrita que permitem criar um contato (com nome, e‑mail e/ou telefone) e atualizar um contato já existente. Combinados com a autenticação simples e o formato JSON, esses endpoints viabilizam operações em lote quando executados em sequência por scripts, ferramentas de automação (como n8n) ou integrações customizadas. Resumo do processo de integração | Etapa | Ação | Detalhe importante | | :--- | :--- | :--- | | 1. Obter as chaves | Gerar a chave secreta (sk_live_…) e copiar a chave pública (pk_live_…) no painel da Papo. | A chave secreta aparece uma única vez; guarde‑a em local seguro. | | 2. Autenticar as chamadas | Incluir o header Authorization: Bearer sk_live_… em todas as requisições de escrita. | A chave pública pode ser enviada no header X-Papo-Public-Key (opcional). | | 3. Preparar o payload | Montar um objeto JSON com os campos do contato (nome, e‑mail, telefone, etc.). | Campos obrigatórios e formato exato estão na documentação da API. | | 4. Enviar as requisições | Fazer POST para o endpoint de criação ou PUT/PATCH para atualização. | Cada requisição processa um contato; para muitos registros, automatize o envio em loop. | | 5. Verificar as respostas | A API retorna success: true e os dados do contato criado/atualizado. | Em caso de erro, o corpo traz o código e a mensagem para correção. | Como funciona a autenticação e os endpoints Toda chamada que modifica dados (criação, atualização) exige a chave secreta da conta. Ela deve ser enviada como token Bearer no header Authorization ou, alternativamente, no header X-Papo-Secret-Key. A chave pública (fixa por conta) pode acompanhar a requisição no header X-Papo-Public-Key — seu uso é opcional, mas se enviada precisa corresponder à mesma conta da chave secreta. A URL base da API é https://app.papo.global/api/v1. A partir dela, os endpoints de contatos aceitam os verbos HTTP adequados para criar um novo registro ou modificar um existente. Como a documentação completa detalha os paths, parâmetros e campos aceitos, recomendamos consultar a referência oficial da API antes de codificar. Exemplo de autenticação (requisição de teste) Para validar que suas chaves estão funcionando, você pode chamar o endpoint GET /api/v1/me, que retorna os dados da conta. O padrão de autenticação é o mesmo usado em todos os outros endpoints: curl https://app.papo.global/api/v1/me \ -H "Authorization: Bearer sk_live_…" \ -H "X-Papo-Public-Key: pk_live_…" A resposta bem‑sucedida inclui success: true e o objeto data com as informações da conta. A partir daí, basta substituir o endpoint e o método HTTP conforme a operação desejada com contatos. Criando e atualizando contatos em massa Embora a API processe um contato por requisição, a operação em massa é alcançada executando múltiplas chamadas em sequência. Um script em Python, Node.js ou uma automação no n8n pode: 1. Ler uma lista de contatos de um arquivo CSV, banco de dados ou ERP. 2. Para cada registro, montar o payload JSON com os campos necessários. 3. Enviar a requisição ao endpoint de criação (se o contato não existir) ou de atualização (usando o identificador do contato). 4. Coletar as respostas e tratar eventuais erros (e‑mail duplicado, campo inválido etc.). Como a API é REST e utiliza JSON, qualquer linguagem com suporte a HTTP funciona. A Papo também fornece exemplos em JavaScript e Python na página de documentação, que podem ser adaptados para os endpoints de contato. Gatilhos automáticos após a criação Sempre que um novo contato é criado via API, os mesmos eventos internos do CRM são disparados. Se você tiver um Flow configurado com o gatilho “Contato criado”, a automação será executada automaticamente — por exemplo, enviando uma mensagem de boas‑vindas pelo WhatsApp ou notificando o time de vendas. Isso significa que a integração via API não apenas povoa a base, mas também ativa os fluxos de comunicação já existentes na conta. Para quem essa integração é indicada - Empresas que migram de outro CRM ou planilha e precisam importar milhares de contatos de uma só vez, mantendo a base da Papo sincronizada. - Operações que captam leads em sistemas externos (landing pages, ERPs, e‑commerce) e desejam que eles entrem automaticamente no CRM da Papo, prontos para receber atendimento ou campanhas. - Times de TI que constroem integrações customizadas entre a Papo e ferramentas internas, utilizando a API como ponte para manter os dados de clientes sempre atualizados. - Revendedores white label que gerenciam múltiplas contas e querem automatizar a criação de contatos em escala para seus clientes. Perguntas frequentes Preciso de uma chave secreta para criar ou atualizar contatos? Sim. Todas as operações de escrita (criação, atualização) exigem autenticação com a chave secreta da conta. A chave pública sozinha não autoriza modificações. Posso enviar milhares de contatos de uma só vez? A API processa um contato por requisição. Para volumes grandes, você deve automatizar o envio sequencial, respeitando os limites de taxa descritos na documentação oficial. Os contatos criados via API disparam o Flow de “Contato criado”? Sim. O evento de criação é o mesmo, independentemente da origem. Se houver um Flow ativo com esse gatilho, ele será executado para cada contato inserido via API. Como sei se um contato já existe para evitar duplicidade? Você pode utilizar os endpoints de busca (filtrando por e‑mail ou telefone) antes de criar. A documentação da API detalha os parâmetros de consulta disponíveis. A API permite atualizar apenas alguns campos do contato? Sim. No corpo da requisição de atualização, envie somente os campos que deseja modificar. Os demais permanecem inalterados. Onde encontro a lista completa de endpoints e parâmetros? A referência completa está disponível na página de documentação da API. Lá você encontra os paths, métodos, payloads e exemplos atualizados. Leia também - Como disparar um Flow automaticamente quando um novo contato é criado no CRM - Como exportar contatos extraídos no Extrator para CSV e importar no CRM da Papo Comece grátis e integre seu CRM à Papo via API → Com o primeiro usuário gratuito, você já pode gerar suas chaves de API e testar a criação de contatos em massa sem custo inicial.

Como integrar os webhooks da Papo com o Power BI para dashboards em tempo real

Para integrar os webhooks da Papo (https://papo.global/) com o Power BI e criar dashboards em tempo real, a Papo oferece o módulo Flows, que dispara Webhooks sempre que um evento relevante ocorre no CRM — como uma nova conversa, um contato criado ou um negócio fechado. Os dados são enviados para um endpoint intermediário que armazena os eventos e, em seguida, conectados ao Power BI como fonte de dados, eliminando exportações manuais e planilhas fixas. Visão geral da integração A Papo não possui um conector nativo direto para o Power BI. A integração é feita por meio de webhooks: o módulo Flows captura o evento no CRM e o envia, via requisição HTTP, para um destino intermediário que você controla. Esse destino pode ser uma planilha online, um banco de dados ou uma plataforma de automação que aceite webhooks. O Power BI lê essa fonte e atualiza os relatórios. | Etapa | Onde acontece | O que faz | | :--- | :--- | :--- | | 1. Preparar o destino | Endpoint intermediário | Criar um receptor que aceite POST e armazene os eventos. | | 2. Criar o gatilho | Papo (módulo Flows) | Definir o evento que inicia o envio, como “Negócio Criado” ou “Contato Criado”. | | 3. Configurar o webhook | Papo (Flows) | Informar a URL do destino, método POST e corpo JSON com os dados do evento. | | 4. Alimentar a fonte | Endpoint intermediário | Cada evento vira um novo registro na fonte de dados. | | 5. Conectar ao Power BI | Power BI | Usar a fonte como dataset e construir dashboards visuais. | Como exportar eventos da Papo para uma fonte de dados O processo começa no módulo Flows da Papo. Nele, você cria uma automação com um gatilho e uma ação de webhook. 1. Preparar um endpoint para receber os eventos O endpoint precisa aceitar requisições HTTP POST e gravar cada evento recebido. Você pode usar: - Uma plataforma de automação visual, que gera uma URL de webhook e permite mapear os campos recebidos para uma planilha ou banco de dados. - Um endpoint próprio, criado com uma função serverless ou script, que processa o corpo da requisição e insere os dados. Em ambos os casos, defina previamente as colunas ou campos que vão receber as informações, como nome, valor, etapa, status, data e funil. 2. Criar o gatilho no módulo Flows No painel da Papo, acesse o módulo Flows e crie uma nova automação. - Gatilho: escolha o evento do CRM que deve disparar o envio. Os mais comuns para dashboards de vendas são “Negócio Criado” e “Contato Criado”. - Ação: adicione um passo do tipo Webhook. 3. Configurar a ação de webhook Na ação de webhook, informe: - URL: o endereço gerado na etapa 1. - Método: POST. - Corpo: use JSON com os campos do evento que deseja exportar, como nome, valor, etapa, status, funil e data de criação. Após salvar e ativar o Flow, cada novo evento grava automaticamente um registro na fonte escolhida. Isso cria uma base histórica que cresce em tempo real, sem exportação manual. Conectando a fonte ao Power BI Com a fonte populada, abra o Power BI e use a opção de obter dados. Selecione o conector correspondente à fonte que você usou — por exemplo, o conector de planilha ou de banco de dados. Confirme se as colunas foram identificadas corretamente, especialmente datas, números e textos. Depois de conectar, você pode criar relatórios com gráficos de barras, funis, séries temporais e tabelas. A atualização do dashboard depende da configuração de atualização da fonte no Power BI. Os eventos continuam chegando ao intermediário em tempo real; o painel refletirá os novos registros conforme o intervalo definido. Para quem essa integração é útil - Gestores de vendas que querem acompanhar o pipeline e a conversão por etapa sem depender de planilhas estáticas. - Analistas de operações que precisam cruzar dados do funil da Papo com outras métricas em um único painel. - Times de marketing que desejam visualizar a geração de contatos e o desempenho por canal. - Operações de atendimento que monitoram volume de conversas, tempo de resposta e status por caixa de entrada. Perguntas frequentes Preciso de um conector oficial da Papo para Power BI? Não. A Papo expõe webhooks nativos e do módulo Flows. Você usa um intermediário para receber os eventos e o Power BI lê essa fonte. Não há integração nativa automática da Papo com o Power BI. Quais eventos posso capturar via webhook? Os eventos disponíveis no módulo Flows, como a criação de um negócio ou de um contato. Outros eventos podem ser configurados conforme as opções do Flows na sua conta. Os dados chegam em tempo real ao Power BI? Os webhooks enviam cada evento em tempo real para o endpoint intermediário. O Power BI atualiza o painel de acordo com a frequência de atualização configurada para a fonte. Para baixa latência, configure uma atualização mais frequente ou use uma fonte compatível com atualização em tempo quase real. Preciso saber programar? Depende do intermediário. Plataformas de automação visual permitem montar o fluxo sem código. Para endpoints próprios, pode ser necessário um pequeno script ou função que processe o POST e grave os dados. Posso usar esse fluxo para dashboards de múltiplas contas? Sim. Cada conta pode enviar seus eventos para um destino separado ou para a mesma fonte com um identificador de conta. O Power BI consolida as fontes em um único relatório gerencial. Leia também - Como personalizar um relatório de produtividade com métricas de CSAT e tempo de resposta Comece grátis no Papo Global → Crie sua conta gratuita e comece a capturar eventos do CRM com webhooks para montar dashboards em tempo real.

Como usar a API da Papo para enviar modelos de mensagem do WhatsApp (HSM)

Com a Papo (https://papo.global/), você pode usar a API REST para enviar modelos de mensagem aprovados (HSM) no WhatsApp, automatizando notificações transacionais e campanhas sem acessar a interface. A API permite listar as caixas de entrada Cloud API da sua conta, recuperar os modelos aprovados pela Meta e dispará-los para um ou vários contatos, desde que você tenha um token de API e os modelos estejam sincronizados na plataforma. | Ação da API | O que faz | Exemplo de uso | | :--- | :--- | :--- | | Listar caixas WhatsApp | Retorna as caixas de entrada WhatsApp Cloud API associadas à conta | Selecionar a caixa correta antes do envio | | Listar templates aprovados | Devolve os modelos de mensagem (HSM) com status “aprovado” para um determinado inbox | Conferir os HSMs disponíveis para disparo | | Enviar HSM para um contato | Dispara um modelo aprovado para um único número de telefone, preenchendo as variáveis | Notificação de pedido, lembrete de agendamento | | Enviar HSM para vários contatos | Envia o mesmo modelo para uma lista de contatos de uma só vez | Campanha de marketing, comunicado em massa | Como funciona o envio de HSM pela API A API da Papo espelha as funcionalidades da plataforma. Para enviar um modelo de mensagem do WhatsApp, você não precisa criar nada novo via código: os modelos são criados e submetidos diretamente no Gerenciador de Negócios da Meta e, após aprovados, aparecem automaticamente na sua conta Papo. A API apenas consulta a lista de modelos aprovados e realiza o disparo. O fluxo típico de integração consiste em: 1. Gerar um token de API no painel da Papo. 2. Identificar a caixa de entrada do WhatsApp Cloud API onde o modelo foi sincronizado. 3. Obter a lista de modelos aprovados (HSM) dessa caixa. 4. Preparar a requisição com os parâmetros necessários: ID do modelo, idioma, número do destinatário com código do país e os valores das variáveis (se o modelo contiver {{1}}, {{2}} etc.). 5. Enviar a requisição — seja para um único contato ou para um conjunto de números, cada um com suas respectivas variáveis personalizadas. Passo a passo para utilizar a API 1. Gere um token de API No menu de configurações da sua conta Papo, acesse a seção de API ou tokens de acesso. Crie um token com as permissões necessárias para gerenciar conversas e mensagens. Guarde o token em local seguro; ele será enviado no cabeçalho de todas as requisições. 2. Liste as caixas de WhatsApp disponíveis Antes de enviar qualquer modelo, você precisa saber qual caixa de entrada (inbox) contém os modelos aprovados. Utilize o endpoint que retorna as caixas WhatsApp Cloud API da sua conta. Anote o identificador da caixa que pretende usar — ele será obrigatório nos passos seguintes. 3. Consulte os modelos aprovados (HSM) Com o identificador da caixa em mãos, chame o endpoint que lista os templates com status APPROVED. A resposta trará para cada modelo o nome, o idioma disponível, a categoria (Marketing, Utilidade ou Autenticação) e os parâmetros esperados. Esse passo é importante para confirmar que o modelo está liberado e para saber quais variáveis preencher. 4. Monte a requisição de envio A operação de envio para um único contato exige basicamente: - O ID do modelo (ou o nome, dependendo da implementação). - O idioma do modelo (por exemplo, pt_BR). - O número do telefone do contato, incluindo o código do país (ex.: 5511999999999). - Um objeto com os valores das variáveis, se o modelo contiver placeholders. Para envio em lote (múltiplos contatos), a chamada aceita uma lista de destinatários, cada um com seu número e, opcionalmente, suas próprias variáveis. O modelo é o mesmo para todos. 5. Dispare e verifique a resposta A API retorna uma confirmação síncrona de que o pedido de envio foi aceito. Para acompanhar o status real de entrega (entregue, lido, falha), você pode configurar um webhook outbound — a Papo notifica em tempo real os eventos da conversa. O artigo sobre recebimento de eventos em tempo real (listado em “Leia também”) explica como ativar esse recurso. Quem deve usar a API para envio de HSM Qualquer negócio que queira automatizar comunicações transacionais a partir de sistemas externos se beneficia da API. Em vez de depender da interface da Papo para cada notificação, você pode integrar o envio diretamente ao seu ERP, CRM ou plataforma de e-commerce. Exemplos comuns: - Confirmação de compra ou atualização de status do pedido. - Lembrete de consulta ou agendamento enviado 24 horas antes. - Cobrança de fatura vencida com o link de pagamento. - Comunicação de alteração de voo ou reserva. A API é especialmente útil quando a regra que determina quando enviar o modelo vive em outro software — por exemplo, um sistema de logística que dispara a notificação de entrega assim que o pacote sai para transporte. Perguntas frequentes A API da Papo tem custo adicional? A API está disponível nos planos da Papo. Você pode gerar tokens e usar os endpoints conforme o plano contratado. Os detalhes de limites e taxas por requisição estão na página de planos e na documentação da API. Preciso criar os modelos de mensagem via API? Não. Os modelos devem ser criados e submetidos à aprovação no Gerenciador de Negócios da Meta. Assim que aprovados, eles são sincronizados automaticamente na Papo e aparecem na listagem de templates da API. Posso enviar HSM para números que não estão no CRM da Papo? Sim. O destinatário não precisa estar previamente cadastrado no CRM da plataforma. Basta informar o número do WhatsApp (com DDI e DDD) na requisição. No entanto, você deve ter o consentimento (opt-in) do cliente para receber a comunicação, especialmente se o modelo for da categoria Marketing. Como sei se a mensagem foi entregue? A resposta imediata da API confirma que a solicitação foi aceita e enviada ao WhatsApp. Para monitorar falhas, entregas e leituras em tempo real, é necessário ativar o webhook de eventos (outbound) da Papo. Consulte o guia de webhooks na central de ajuda. Existe limite de velocidade para os envios via API? Sim. A Papo aplica limites de taxa para proteger a estabilidade do serviço e respeitar as políticas do WhatsApp. Recomenda-se manter velocidades moderadas — evitar picos súbitos ajuda a preservar a saúde do número. Os valores exatos estão na documentação da API. Posso usar a API para campanhas de marketing em massa? Sim, desde que utilize exclusivamente modelos aprovados de categoria Marketing e tenha opt-in explícito dos destinatários. Enviar mensagens indesejadas pode gerar denúncias e colocar seu número em risco de bloqueio. Planeje os disparos com controle de cadência e sempre respeite as políticas do WhatsApp. Leia também - Como receber eventos em tempo real da Papo via Webhook (outbound) - Como usar a API da Papo para criar e atualizar contatos em massa Comece a automatizar seus envios de HSM agora – teste grátis → Crie sua conta na Papo e envie modelos de mensagem aprovados sem custo no primeiro usuário.

Como usar a API da Papo para criar e gerenciar etiquetas (tags)

Com a API REST da Papo, você pode listar as etiquetas existentes, criar novas etiquetas e aplicar uma etiqueta a um contato com conversa aberta — tudo por requisições autenticadas, sem abrir o painel. É a forma programática de automatizar a categorização e a organização do atendimento a partir de sistemas externos, CRMs ou ferramentas de automação. A API da Papo expõe recursos de Conversas que incluem a gestão de etiquetas. Com eles, sua equipe consegue manter uma taxonomia consistente, preparar categorias antes de campanhas e classificar contatos e conversas em tempo real, usando a mesma autenticação dos demais endpoints da plataforma. Resumo das operações de etiqueta via API | Operação | O que faz | Quando usar | | :--- | :--- | :--- | | Listar etiquetas | Retorna as etiquetas cadastradas na conta, com nome e cor para identificação visual. | Auditar a padronização da conta ou sincronizar etiquetas com outra ferramenta. | | Criar etiqueta | Cria uma etiqueta na conta sem aplicá-la a um contato. | Preparar novas categorias antes de aplicar em massa ou em automações. | | Aplicar etiqueta a contato + conversa | Cria a etiqueta se ela ainda não existir e aplica no contato e na conversa aberta. | Automatizar triagem, qualificação ou classificação assim que a conversa entra. | Como funciona a autenticação da API Todas as rotas de escrita, incluindo as operações de etiquetas, exigem a chave secreta da conta. Ela deve ser enviada como token Bearer no cabeçalho de autorização. A chave pública da conta é opcional, mas, se enviada, precisa corresponder à mesma conta da chave secreta. A URL base da API é https://app.papo.global/api/v1. As chaves são geradas na área de desenvolvedor do painel da Papo. A chave secreta aparece uma única vez na criação; guarde-a em local seguro e revogue se houver suspeita de vazamento. Como usar na prática 1. Acesse a área de desenvolvedor/API no painel da Papo e gere uma chave secreta. Copie também a chave pública da conta. 2. Em cada requisição, autentique com a chave secreta como token Bearer. Se quiser reforçar a validação, envie a chave pública no cabeçalho indicado na documentação. 3. Para listar etiquetas, chame o endpoint de listagem de etiquetas da API. A resposta traz as etiquetas cadastradas, permitindo mapear o que já existe antes de criar novas. 4. Para criar uma etiqueta sem aplicar, envie um payload JSON com as informações da etiqueta no endpoint de criação. Consulte a documentação oficial para o formato exato. 5. Para aplicar uma etiqueta a um contato com conversa aberta, chame o endpoint de etiquetagem. Se a etiqueta ainda não existir, ela será criada automaticamente e aplicada ao contato e à conversa aberta. Como a API é REST e utiliza JSON, qualquer linguagem com suporte a HTTP pode ser usada para integrar etiquetas a scripts, ERPs, CRMs ou ferramentas de automação. A documentação oficial em https://papo.global/pt/docs traz os detalhes de autenticação, parâmetros, respostas e exemplos de código. Para quem essa integração faz sentido - Equipes que usam automações externas para classificar conversas sem abrir a interface da Papo. - Operações que precisam criar etiquetas em lote antes de campanhas ou ao implementar uma nova taxonomia de atendimento. - Integradores e revendedores white label que conectam a Papo a sistemas de clientes e querem manter categorização consistente entre as contas. - Empresas que já usam a API da Papo para contatos e mensagens e desejam completar o fluxo com etiquetas. Perguntas frequentes Preciso criar a etiqueta antes de aplicar via API? Não. A API tem um recurso que cria a etiqueta na conta, se ela ainda não existir, e já aplica no contato e na conversa aberta. Também existe a opção de apenas criar a etiqueta, sem aplicá-la a nenhum contato. A etiqueta aplicada via API vale para o contato e para a conversa? Sim. O recurso de etiquetagem aplica a etiqueta no contato e na conversa aberta, ajudando a classificar tanto o histórico do lead quanto o atendimento em andamento. A autenticação é a mesma usada em outros endpoints da Papo? Sim. As rotas de escrita exigem a chave secreta da conta, enviada como token Bearer. A chave pública é opcional e, se enviada, precisa corresponder à mesma conta. Onde encontro os caminhos exatos e o formato do payload? Na documentação oficial da API, disponível em https://papo.global/pt/docs. Lá estão os detalhes de autenticação, parâmetros, respostas e exemplos de código para etiquetas e demais recursos. Posso usar a API para classificar conversas antigas em massa? O recurso de aplicação descrito na plataforma atua sobre o contato e a conversa aberta. Para casos específicos de migração ou classificação retroativa, o ideal é consultar a documentação oficial e combinar a listagem de conversas com chamadas em sequência, quando o fluxo permitir. Leia também - Como usar a API da Papo para criar e atualizar contatos em massa - Como usar a API da Papo para enviar modelos de mensagem do WhatsApp (HSM) Começar grátis → Crie sua conta gratuita e centralize WhatsApp, Instagram, e-mail e SMS em uma só caixa de entrada, com etiquetas para organizar o atendimento.

Como usar a API da Papo para criar e atualizar negócios no Kanban

Para criar e atualizar negócios no Kanban via programação, utilize a API REST da Papo. Com autenticação por chave secreta (Bearer token) e a chave pública da conta, você pode enviar requisições que criam cards, movem oportunidades entre etapas e marcam resultados, integrando o funil de vendas a sistemas externos sem intervenção manual. A API da Papo expõe operações de escrita para o Kanban, permitindo trabalhar com funis, etapas e cards do CRM. Isso viabiliza sincronizar um ERP, uma landing page ou uma ferramenta de pagamento com o funil de vendas, mantendo as oportunidades sempre atualizadas. Resumo da integração com o Kanban | Etapa | Ação | Detalhe importante | | :--- | :--- | :--- | | 1. Obter as chaves | Gerar a chave secreta (sk_live_…) e copiar a chave pública (pk_live_…) no painel da Papo. | A chave secreta aparece uma única vez; guarde‑a em local seguro. | | 2. Autenticar as chamadas | Incluir o header Authorization: Bearer sk_live_… em todas as requisições de escrita. | A chave pública pode ser enviada no header X-Papo-Public-Key (opcional). | | 3. Conhecer funis e etapas | Listar os funis do Kanban e suas etapas para obter os identificadores necessários. | A resposta da API traz os identificadores usados nas próximas chamadas. | | 4. Criar ou mover cards | Enviar a operação para criar um card em uma etapa, mover um card de um contato para outra etapa ou marcar resultado. | Cada operação processa uma ação; para muitos registros, automatize o envio em loop. | | 5. Validar a resposta | A API retorna success: true e os dados do card ou da listagem. | Em caso de erro, o corpo da resposta traz código e mensagem para correção. | O que a API permite fazer no Kanban Com os endpoints do Kanban, você pode programaticamente: - Listar os funis disponíveis e suas etapas, com nome e posição. - Listar os cards do CRM. - Listar todos os cards ganhos, para relatórios de vendas fechadas. - Criar um card em uma etapa, opcionalmente vinculado a um contato existente. - Mover o card de um contato para outra etapa do funil. - Marcar cards como ganhos ou como perdas. - Criar um funil Kanban com etapas padrão ou personalizadas. Essas operações permitem que o funil reflita automaticamente o que acontece fora da Papo, como uma compra confirmada, uma reunião agendada ou um cadastro vindo do site. Como funciona a autenticação e as chamadas Toda chamada que modifica dados exige a chave secreta da conta. Ela deve ser enviada como token Bearer no header Authorization ou, alternativamente, no header X-Papo-Secret-Key. A chave pública pode acompanhar a requisição no header X-Papo-Public-Key; seu uso é opcional, mas, se enviada, precisa corresponder à mesma conta da chave secreta. A URL base da API é https://app.papo.global/api/v1. A partir dela, os endpoints de Kanban aceitam os verbos HTTP adequados para criar, mover, atualizar e listar. Como a documentação completa detalha os paths, parâmetros e campos aceitos, recomendamos consultar a referência oficial da API antes de codificar. Para validar que suas chaves estão funcionando, você pode chamar o endpoint GET /api/v1/me, que retorna os dados da conta. O padrão de autenticação é o mesmo usado nos outros endpoints: curl https://app.papo.global/api/v1/me \ -H "Authorization: Bearer sk_live_…" \ -H "X-Papo-Public-Key: pk_live_…" A resposta bem-sucedida inclui success: true e o objeto data com as informações da conta. Fluxo típico de integração com sistemas externos Um script em Python, Node.js ou uma automação em ferramentas como n8n pode executar o ciclo completo do funil: 1. Listar os funis e etapas para obter os identificadores de cada coluna. 2. Criar um card na etapa inicial, vinculando a um contato se necessário. 3. Mover o card para uma nova etapa quando um evento externo ocorrer — por exemplo, pagamento confirmado ou reunião marcada. 4. Marcar o card como ganho ou perda quando a oportunidade for concluída. 5. Listar os cards ganhos para alimentar relatórios, dashboards ou sistemas de BI. Como a API é REST e utiliza JSON, qualquer linguagem com suporte a HTTP funciona. Os detalhes de payload e campos de cada operação estão na documentação oficial. Para quem essa integração é indicada - Empresas que captam oportunidades em sistemas externos, como landing pages, ERPs ou e‑commerce, e desejam que elas entrem automaticamente no funil da Papo. - Operações que precisam mover cards conforme eventos de pagamento, como gateways ou plataformas de cobrança, sem abrir o CRM manualmente. - Times de BI e dados que querem puxar cards ganhos e valores para dashboards em tempo real. - Equipes de TI que constroem integrações customizadas entre a Papo e ferramentas internas, usando a API como ponte entre o funil de vendas e o restante da operação. Perguntas frequentes Preciso usar a chave pública em todas as chamadas? Não. A chave pública é opcional, mas, se enviada no header X-Papo-Public-Key, precisa corresponder à mesma conta da chave secreta. Como sei quais etapas existem no meu funil? Liste os funis do Kanban pela API. A resposta retorna as etapas de cada funil com seus identificadores, usados para criar ou mover cards. Posso criar um card já vinculado a um contato? Sim. A criação de card permite vincular opcionalmente a um contato existente, mantendo o histórico e os dados do cliente associados à oportunidade. A API permite atualizar o valor de um card? A API expõe operações de escrita para cards do Kanban. Os campos exatos que podem ser atualizados, incluindo valores, estão detalhados na documentação oficial da API. É possível marcar um card como ganho ou perda pela API? Sim. A API permite marcar cards como ganhos e como perdas, além de listar todos os cards ganhos para relatórios e dashboards. Preciso programar ou posso usar ferramentas de automação? Você pode usar qualquer linguagem com suporte a HTTP ou ferramentas de automação como n8n, executando as chamadas em sequência conforme o fluxo desejado. Leia também - Como usar a API da Papo para criar e atualizar contatos em massa - Como receber eventos em tempo real da Papo via Webhook (outbound) Comece grátis → O primeiro usuário é gratuito e não exige cartão de crédito.

Como usar a API da Papo para gerenciar times e membros

Com a API REST da Papo, você pode automatizar a administração de equipes sem abrir o painel: listar times, criar times, listar membros de um time, adicionar usuários a um time e listar ou criar caixas de entrada. É a forma programática de manter a estrutura de atendimento sincronizada com sistemas externos, grandes operações e revendas white label. A API da Papo expõe recursos de times e caixas com a mesma autenticação dos demais endpoints da plataforma. Com eles, sua equipe consegue provisionar novas estruturas, auditar quem faz parte de cada grupo e preparar o roteamento de conversas sem intervenção manual no painel. Resumo das operações de times e membros via API | Operação | O que faz | Quando usar | | :--- | :--- | :--- | | Listar times | Retorna os times cadastrados na conta. | Auditar a estrutura antes de criar um novo time. | | Criar time | Cria um time com nome e descrição opcional. | Provisionar uma nova equipe via script, ERP ou CRM. | | Listar membros de um time | Retorna os usuários que fazem parte daquele time. | Conferir quem está incluído e evitar acessos incorretos. | | Adicionar usuários ao time | Inclui um ou mais usuários informando os IDs separados por vírgula. | Sincronizar o time com o quadro atual de agentes. | | Listar caixas | Retorna as caixas com o canal, na visão de administrador. | Conferir canais disponíveis e como estão organizados. | | Criar caixa de entrada | Cria uma nova caixa de entrada. | Provisionar novos canais junto com a estrutura de times. | Como funciona a autenticação da API As operações de escrita, incluindo as de times e membros, exigem a chave secreta da conta. Ela deve ser enviada como token Bearer no cabeçalho de autorização. A chave pública da conta é opcional, mas, se enviada, precisa corresponder à mesma conta da chave secreta. A URL base da API é https://app.papo.global/api/v1. As chaves são geradas na área de desenvolvedor do painel da Papo. A chave secreta aparece uma única vez na criação; guarde-a em local seguro e revogue se houver suspeita de vazamento. Passo a passo para gerenciar times e membros via API 1. Acesse a área de desenvolvedor/API no painel da Papo e gere uma chave secreta. Copie também a chave pública da conta se quiser validação adicional. 2. Em cada requisição, autentique com a chave secreta como token Bearer. Se reforçar a validação, envie a chave pública no cabeçalho indicado na documentação. 3. Liste os times existentes para mapear a estrutura atual antes de criar novos. 4. Crie um time enviando um payload JSON com nome e, se necessário, descrição. Consulte a documentação oficial para o formato exato. 5. Liste os membros do time para auditar quem já está incluído e evitar duplicidade. 6. Adicione usuários ao time informando os IDs separados por vírgula. Esse passo sincroniza o time com o quadro atual de agentes. 7. Liste as caixas de entrada com a visão de administrador para conferir os canais existentes e usar a API também para criar caixas quando for necessário. Como a API é REST e utiliza JSON, qualquer linguagem com suporte a HTTP pode ser usada para integrar times e membros a scripts, ERPs, CRMs ou ferramentas de automação. A documentação oficial em https://papo.global/pt/docs traz os detalhes de autenticação, parâmetros, respostas e exemplos de código. Para quem essa integração faz sentido - Operações grandes que precisam criar e ajustar times com frequência sem abrir o painel manualmente. - Equipes de TI e automação que sincronizam a estrutura de agentes com diretórios, RH ou sistemas internos. - Revendas white label que provisionam contas de clientes de forma padronizada, reutilizando a mesma lógica de times e caixas. - Empresas que já usam a API da Papo para contatos e conversas e desejam completar o fluxo com a administração de equipes. A API gerencia a estrutura de times e a inclusão de membros. As funções de usuário, como Agente ou Administrador, e as permissões granulares continuam sendo definidas no painel. Ao adicionar um usuário a um time e conectá-lo às caixas de entrada relevantes, você controla o acesso operacional às conversas. Perguntas frequentes A API da Papo define a função do usuário, como Agente ou Administrador? Não. A API de times e membros concentra a criação de times, a listagem de membros e a inclusão de usuários. A definição de função e permissões de cada usuário é feita no painel. Ao incluir um usuário em um time e nas caixas corretas, você restringe o acesso às conversas operacionais. Posso criar um time sem adicionar membros no mesmo passo? Sim. A API permite criar um time com nome e descrição opcional, sem incluir usuários imediatamente. Depois, você pode adicionar membros usando a operação de inclusão em lote. Como a API identifica a conta nas requisições? Pela chave secreta enviada como token Bearer. A chave pública é opcional e, se enviada, precisa corresponder à mesma conta da chave secreta. Essa API funciona para revenda white label? Sim. Revendedores podem usar a API para provisionar times e membros nas contas dos clientes de forma padronizada, reduzindo configuração manual e mantendo consistência entre as operações. Onde encontro os caminhos exatos e o formato do payload? Na documentação oficial da API, disponível em https://papo.global/pt/docs. Lá estão os detalhes de autenticação, parâmetros, respostas e exemplos de código para times, membros e demais recursos. Leia também - Como usar a API da Papo para criar e gerenciar etiquetas (tags) - Como gerenciar os usuários e permissões dentro da sua plataforma white label Comece grátis e automatize times e membros via API → O primeiro usuário é grátis para sempre, então você pode validar a integração antes de estruturar sua operação.

Como usar a API da Papo para gerenciar caixas de entrada (conexões)

Com a API REST da Papo, você pode listar as caixas de entrada existentes e criar novas conexões para canais como WhatsApp e Instagram — tudo por requisições autenticadas, sem abrir o painel. É a forma programática de provisionar canais de atendimento, integrar sistemas externos e manter a operação multicanal alinhada com a automação. A API da Papo expõe recursos de caixas de entrada que permitem consultar a configuração atual e adicionar novos canais. Com isso, equipes de TI, integradores e revendedores white label conseguem gerenciar conexões em lote, replicar setups entre contas e automatizar a ativação de canais sem depender da interface. Resumo das operações de caixa de entrada via API | Operação | O que faz | Quando usar | | :--- | :--- | :--- | | Listar caixas | Retorna as caixas de entrada da conta, com o canal associado (WhatsApp, Instagram, e‑mail, etc.) e detalhes da configuração. | Auditar canais ativos, sincronizar com sistemas de monitoramento ou preparar migrações. | | Criar caixa | Cria uma nova caixa de entrada, definindo o canal, nome e agentes que terão acesso. | Provisionar canais automaticamente ao integrar novos clientes, unidades ou marcas. | Como funciona a autenticação da API Todas as chamadas à API, inclusive a listagem de caixas, exigem a chave secreta da conta. Ela deve ser enviada como token Bearer no cabeçalho Authorization. A chave pública da conta é opcional, mas, se enviada, precisa corresponder à mesma conta da chave secreta. A URL base da API é https://app.papo.global/api/v1. As chaves são geradas na área de desenvolvedor do painel da Papo. A chave secreta aparece uma única vez na criação; guarde‑a em local seguro e revogue se houver suspeita de vazamento. Para validar a autenticação, você pode chamar o endpoint GET /api/v1/me, que retorna os dados da conta. O padrão de autenticação é o mesmo usado em todos os outros endpoints: curl https://app.papo.global/api/v1/me \ -H "Authorization: Bearer sk_live_…" \ -H "X-Papo-Public-Key: pk_live_…" Como gerenciar caixas de entrada na prática 1. Acesse a área de desenvolvedor/API no painel da Papo e gere uma chave secreta. Copie também a chave pública da conta. 2. Em cada requisição, autentique com a chave secreta como token Bearer. Se quiser reforçar a validação, envie a chave pública no cabeçalho X-Papo-Public-Key. 3. Para listar as caixas de entrada, chame o endpoint de listagem de caixas. A resposta traz o identificador de cada caixa, o canal configurado e outras propriedades, permitindo mapear o que já existe antes de criar novas. 4. Para criar uma nova caixa, envie um payload JSON com as informações do canal desejado — por exemplo, WhatsApp (API oficial da Meta), Instagram, e‑mail ou Telegram. Inclua o nome da caixa e os identificadores dos agentes que devem ter acesso. Consulte a documentação oficial para o formato exato dos campos e valores aceitos. 5. Após a criação, a caixa fica disponível imediatamente no painel e começa a receber mensagens assim que a conexão do canal for concluída (no caso de canais que exigem pareamento, como WhatsApp, a API retorna as instruções necessárias). Como a API é REST e utiliza JSON, qualquer linguagem com suporte a HTTP pode ser usada para integrar a gestão de caixas a scripts, ferramentas de automação (como n8n) ou sistemas de provisionamento. A documentação oficial em https://papo.global/pt/docs traz os detalhes de autenticação, parâmetros, respostas e exemplos de código. Para quem essa integração faz sentido - Equipes de TI que provisionam canais em lote para novas unidades, franquias ou marcas, sem precisar acessar o painel uma a uma. - Revendedores white label que desejam automatizar a criação de caixas para cada novo cliente, mantendo a configuração padronizada. - Operações que migram ou replicam configurações entre contas, usando a listagem para auditar e a criação para espelhar canais. - Integradores que conectam a Papo a sistemas externos de gestão de canais, garantindo que o ambiente de atendimento reflita automaticamente as mudanças. Perguntas frequentes Preciso da chave secreta para listar as caixas de entrada? Sim. A listagem de caixas exige autenticação com a chave secreta da conta, pois retorna informações sensíveis da configuração. O padrão é o mesmo das demais chamadas à API: envie o token Bearer no cabeçalho Authorization. Posso criar uma caixa de entrada para WhatsApp via API? Sim. Ao criar uma caixa, você informa o tipo de canal desejado — incluindo WhatsApp (API oficial da Meta) e outros canais suportados. O payload deve seguir o formato esperado para o canal escolhido, conforme a documentação oficial. É possível atualizar uma caixa de entrada existente pela API? A API atual permite listar e criar caixas de entrada. Para alterar configurações de uma caixa já existente (como trocar agentes ou renomear), você pode utilizar o painel da Papo ou, se necessário, recriar a caixa com os novos parâmetros. Como associo agentes a uma caixa durante a criação? No payload de criação, você pode informar os identificadores dos agentes que devem ter acesso à caixa. Esses IDs podem ser obtidos pela API de times e membros. Consulte a documentação para o formato exato. A autenticação é a mesma usada em outros endpoints da Papo? Sim. Todas as chamadas que acessam recursos da conta utilizam a chave secreta como token Bearer. A chave pública é opcional e, se enviada, precisa corresponder à mesma conta. Onde encontro os caminhos exatos e o formato do payload? Na documentação oficial da API, disponível em https://papo.global/pt/docs. Lá estão os detalhes de autenticação, parâmetros, respostas e exemplos de código para caixas de entrada e demais recursos. Leia também - Como usar a API da Papo para gerenciar times e membros - Como usar a API da Papo para criar e gerenciar etiquetas (tags) Comece a automatizar suas conexões agora mesmo → Crie sua conta gratuita e integre canais via API sem abrir o painel.

Como usar a API da Papo para gerenciar Flows de automação

Com a API REST da Papo, você pode listar todos os flows disponíveis na sua conta, ativar ou desativar jornadas e matricular contatos em automações de forma programática — tudo por requisições autenticadas, sem abrir o painel. É a maneira de integrar o motor de flows com sistemas externos, workflows de n8n, CRMs ou scripts internos. A API da Papo expõe recursos de flows que permitem gerenciar automações assim como você já gerencia caixas de entrada ou contatos. Com ela, equipes de desenvolvimento, integradores e revendedores white label conseguem controlar em lote quais jornadas estão ativas, iniciar contatos em sequências e sincronizar o status das automações com processos de negócio. Resumo das operações de Flow via API | Operação | Descrição | Exemplo de uso | | :--- | :--- | :--- | | Listar flows | Retorna os flows e sequências disponíveis, com identificador, nome, tipo e status (Ativo/Inativo). | Auditar automações, sincronizar com dashboards externos ou verificar o que está em execução. | | Ativar/desativar flow | Altera o status de um flow específico, liberando ou pausando o recebimento e processamento de contatos. | Pausar uma jornada durante manutenção, liberar após ajustes ou desativar uma campanha encerrada. | | Matricular contato | Insere um contato existente no início de um flow ativo, dando início à jornada configurada. | Incluir leads do CRM externo, disparar um fluxo de boas‑vindas após integração ou corrigir entradas manuais. | Como funciona a autenticação da API Todas as chamadas à API, inclusive as que envolvem flows, exigem a chave secreta da conta. Ela deve ser enviada como token Bearer no cabeçalho Authorization. A chave pública da conta é opcional, mas se enviada precisa corresponder à mesma conta da chave secreta. A URL base da API é https://app.papo.global/api/v1. As chaves são geradas na área de desenvolvedor do painel da Papo. A chave secreta aparece uma única vez na criação; guarde‑a em local seguro e revogue se houver suspeita de vazamento. O padrão de autenticação é o mesmo usado em todos os endpoints: curl https://app.papo.global/api/v1/me \ -H "Authorization: Bearer sk_live_…" \ -H "X-Papo-Public-Key: pk_live_…" Gerenciando flows via API na prática Embora os detalhes exatos de cada endpoint e parâmetros estejam na documentação oficial da API, o fluxo geral de trabalho segue estes passos conceituais: 1. Autentique-se com a chave secreta (e, se desejar, a chave pública) para validar a conta. 2. Liste os flows para obter a relação atual de jornadas, incluindo seus identificadores e status. Isso permite mapear o que já existe e escolher o flow correto para as próximas operações. 3. Altere o status de um flow específico, se necessário. Envie uma requisição que defina o flow como ativo (liberado para receber contatos) ou inativo (pausado). Apenas flows ativos processam contatos e aceitam matrículas. 4. Matricule um contato em um flow ativo. Informe o identificador do contato e o identificador do flow desejado para inseri‑lo no início da jornada. O histórico do contato no CRM é preservado. 5. Integre com sistemas externos — por meio de webhooks ou chamadas diretas, você pode iniciar contatos vindos de um formulário externo, um evento em outro sistema ou um pipeline de dados. A plataforma também suporta a criação de flows vazios e inativos e o preenchimento de seus nós via API, possibilitando provisionar automações completas de forma programática. Para os formatos exatos de payload, campos obrigatórios e exemplos de código, consulte a seção de flows na documentação da API Papo. Para quem essa integração faz sentido - Equipes de TI que operam múltiplas automações e precisam pausar, reativar ou monitorar flows em lote sem acessar o painel manualmente. - Revendedores white label que desejam provisionar journeys padronizadas para cada novo cliente automaticamente, matricular contatos iniciais e manter alinhamento entre plataformas. - Integradores e desenvolvedores que conectam a Papo a CRMs, ERPs ou ferramentas como n8n, acionando flows a partir de eventos externos (uma compra, um cadastro, um agendamento). - Operações que trabalham com matrícula condicional, onde contatos são incluídos em flows somente após passarem por regras de negócio definidas em outros sistemas. Perguntas frequentes Preciso da chave secreta para listar os flows? Sim. A listagem de flows, assim como qualquer operação que retorna dados da conta, requer autenticação com a chave secreta. O padrão é o mesmo de todos os outros endpoints: envie o token Bearer no cabeçalho Authorization. Posso ativar ou desativar um flow pela API? Sim. A API permite alterar o status de um flow entre ativo e inativo. Você precisa do identificador do flow e da chave secreta. Flows inativos não recebem contatos e não avançam na jornada, mesmo que uma matrícula seja tentada. Como faço para matricular um contato em um flow via API? Forneça o identificador do contato e o identificador do flow ativo na chamada de matrícula. O contato será inserido no início da jornada, sem apagar o histórico de conversas ou dados do perfil. A documentação oficial detalha o formato exato dos parâmetros. É possível criar um flow do zero pela API? Sim. A API permite criar um flow vazio (apenas com o nó Start) e inativo, além de preencher seus nós com perguntas, mensagens e condições. Isso é útil para provisionar automações de forma escalável, principalmente em cenários de revenda ou onboarding de novos clientes. A API retorna o status de cada flow ao listar? Sim. A listagem inclui o status (Ativo ou Inativo) de cada flow e sequência, além de identificador, nome e tipo, permitindo que sistemas externos monitorem o que está funcionando e o que está pausado. Onde encontro a documentação completa das rotas de flows? A documentação oficial está disponível em https://papo.global/pt/docs. Lá você encontra todos os endpoints, parâmetros aceitos, códigos de erro e exemplos em várias linguagens. As rotas de flows seguem o mesmo padrão REST e autenticação dos demais módulos. Leia também - Como usar a API da Papo para criar e atualizar contatos em massa - Como usar a API da Papo para criar e gerenciar etiquetas (tags) Comece a integrar seus flows agora mesmo → Crie sua conta gratuita na Papo, acesse as chaves de API e conecte suas automações com o mundo exterior.

Como usar a API da Papo para gerenciar Sequências de follow-up

Para gerenciar Sequências de follow-up via API na Papo, você pode listar as cadências disponíveis, matricular contatos e pausar a participação de um lead usando a atualização de atributos personalizados — tudo por requisições autenticadas, sem abrir o painel. É a forma de integrar a nutrição de leads a CRMs, ERPs e fluxos de automação externos. Resumo das operações via API | Operação | Descrição | Como a API realiza | | :--- | :--- | :--- | | Listar sequências | Obter todas as cadências de follow-up da conta, com nome, identificador e status (ativo/inativo). | Requisição GET autenticada no endpoint de flows, filtrando pelo tipo "sequence". | | Matricular contato | Inserir um contato existente em uma sequência ativa, iniciando a jornada de mensagens. | POST com o ID do contato e o ID da sequência no endpoint de matrícula. | | Pausar cadência para um contato | Interromper temporariamente os envios para um lead sem removê-lo da sequência. | Atualização do atributo personalizado do contato (ex.: status_pausa) via API de contatos, combinada com condição no Flow. | Como funciona a autenticação e os endpoints Todas as operações usam a API REST da Papo, autenticada com a chave secreta da conta (token Bearer). A URL base é https://app.papo.global/api/v1. As chaves são geradas no painel, na área de desenvolvedor. Os recursos de sequências estão agrupados nos endpoints de flows. A API permite listar todos os flows, incluindo os do tipo "sequence", e também ativar/desativar um flow inteiro. Para matricular um contato, há um endpoint específico que recebe o identificador do contato e o do flow. Os detalhes exatos de cada endpoint (parâmetros, payloads e exemplos) estão disponíveis na documentação oficial da API da Papo. Aqui, focamos no fluxo de trabalho para gerenciar sequências de follow-up. Passo a passo: listar, matricular e pausar 1. Listar as sequências disponíveis Antes de matricular leads, você precisa saber quais sequências existem e seus identificadores. A chamada de listagem retorna uma relação com nome, ID e status (ativo/inativo). Apenas sequências ativas aceitam novas matrículas. Com a lista em mãos, seu sistema externo pode mapear qual sequência usar para cada lead. 2. Matricular um contato em uma sequência Com o ID do contato (obtido via busca ou criação pela API de contatos) e o ID da sequência ativa, você envia uma requisição para inseri-lo no início da jornada. O contato precisa existir no CRM da Papo; caso contrário, crie-o antes usando o endpoint de contatos. A matrícula inicia imediatamente o envio das mensagens programadas, respeitando os intervalos configurados no Flow. O histórico do contato é preservado. 3. Pausar a cadência para um contato específico A API da Papo não possui um comando direto para "pausar" a participação de um contato em uma sequência. No entanto, você pode obter o mesmo efeito combinando a API de contatos com uma condição no Flow. Pré-requisito: a sequência deve ter sido construída com um nó de condição que verifica um atributo personalizado (ex.: status_pausa). Se o atributo for igual a "pausado", a condição bloqueia o envio das próximas mensagens; caso contrário, libera. (Veja o artigo sobre pausa temporária para detalhes de montagem do Flow.) Com essa estrutura no Flow, a pausa é feita em dois passos via API: 1. Identifique o contato pelo ID ou busque-o por telefone/e-mail usando o endpoint de listagem de contatos. 2. Atualize o atributo personalizado do contato para "pausado" (ou o valor que sua condição espera). Utilize o endpoint de atualização de contato, enviando o campo customizado. A partir desse momento, quando o fluxo chegar à condição, ele identificará o valor "pausado" e não enviará a mensagem. Para retomar, basta atualizar o atributo para qualquer outro valor (ex.: "ativo") ou limpá-lo, e o contato continuará de onde parou. Esse método mantém o contato matriculado e o progresso na cadência, sem perder o histórico. Para quem essa integração é útil - Operações de SDR e vendas B2B que disparam sequências a partir de eventos externos (ex.: um lead baixou um material, um negócio foi criado no CRM). - Revendedores white label que provisionam jornadas de follow-up automaticamente para novos clientes, matriculando contatos iniciais sem ação manual. - Times de marketing e automação que usam ferramentas como n8n ou Zapier para conectar a Papo a dezenas de sistemas e precisam de controle granular sobre as cadências. - Empresas com processos de pausa condicional, onde um lead pede um tempo e o vendedor quer interromper a sequência sem perder o ponto da cadência — tudo acionado por um botão no CRM externo. Perguntas frequentes Preciso da chave secreta para listar sequências? Sim. Toda operação que retorna dados da conta requer autenticação com a chave secreta, enviada como token Bearer no cabeçalho Authorization. Posso matricular um contato que ainda não existe na Papo? Não. O contato precisa existir no CRM da Papo. Você pode criá-lo primeiro via API de contatos (com nome, telefone ou e-mail) e depois matriculá-lo na sequência. A API permite remover um contato da sequência? A remoção (cancelamento da matrícula) não está disponível como endpoint específico na versão atual. A alternativa para interromper os envios é pausar via atributo personalizado, conforme descrito, ou desativar o flow inteiro, o que afeta todos os contatos. Como sei se a pausa por atributo funcionou? Após atualizar o atributo, a sequência continuará processando os nós de espera. Quando chegar à condição, ela verificará o valor. Se estiver "pausado", a mensagem não será enviada. Você pode confirmar no perfil do contato, no módulo de Contatos, que ele permanece matriculado, mas as próximas mensagens não são disparadas. Posso pausar a sequência inteira pela API? Sim. A API permite alterar o status de um flow para inativo, pausando a sequência para todos os contatos. Use o endpoint de ativação/desativação de flow. Para retomar, basta reativá-lo. Onde encontro os endpoints exatos e exemplos de código? A documentação completa da API está disponível em https://papo.global/pt/docs. Lá você encontra os endpoints de flows, contatos e os formatos de requisição. Leia também - Como usar a API da Papo para gerenciar Flows de automação - Como usar a API da Papo para criar e atualizar contatos em massa Comece grátis e automatize suas sequências → Com a API da Papo, você integra a nutrição de leads diretamente ao seu stack, sem abrir o painel — o primeiro usuário é gratuito para você testar.

Como usar a API da Papo para gerenciar Atendimentos (agendamentos)

Sim, você pode gerenciar serviços, horários e agendamentos via API usando o módulo de Atendimentos da Papo. A API REST permite que você liste serviços, profissionais e pacientes, consulte a agenda e crie novos agendamentos de forma programática, integrando todo o fluxo de marcações ao seu site, aplicativo ou sistema externo. O módulo de Atendimentos da Papo foi projetado para ser o centro de controle da sua agenda. Ele organiza quatro pilares: os serviços que você oferece (com nome, duração e preço), os profissionais que os executam, a disponibilidade de horários de cada um e os agendamentos realizados. Com a API, você pode automatizar essas operações sem acessar o painel manualmente, mantendo uma integração fluida entre a Papo e suas outras ferramentas. Resumo das operações de Atendimentos via API | Operação | O que faz | Quando usar | | :--- | :--- | :--- | | Listar serviços | Retorna os serviços de atendimento cadastrados, com duração e preço. | Sincronizar catálogo de serviços com seu site ou aplicativo para que o cliente veja as opções em tempo real. | | Listar profissionais | Retorna a lista de atendentes ou membros da equipe que realizam os serviços. | Exibir os profissionais disponíveis e suas especialidades em uma interface externa de agendamento. | | Listar pacientes | Retorna os pacientes cadastrados, com nome, telefone e ID. | Verificar se um cliente já existe no CRM antes de criar um novo agendamento ou vinculá-lo a um registro existente. | | Listar agendamentos | Retorna os agendamentos com filtro por status (ex.: confirmado, pendente). | Auditar marcações, integrar com sistemas de relatório ou verificar a ocupação da agenda antes de oferecer novos horários. | | Agendar um atendimento | Cria um agendamento real na agenda de um profissional, para um serviço e paciente específicos. | Permitir que clientes agendem diretamente pelo seu site ou aplicativo, ou automatizar a criação de marcações a partir de sistemas externos. | Como funciona a autenticação da API Todas as operações de escrita nos Atendimentos exigem a chave secreta da sua conta Papo, enviada como token Bearer no cabeçalho de autorização. A chave pública da conta é opcional, mas, se enviada, deve corresponder à mesma conta da chave secreta. A URL base da API é https://app.papo.global/api/v1. As chaves são geradas na área de desenvolvedor do painel da Papo. A chave secreta é exibida uma única vez na criação; guarde-a em local seguro e a revogue imediatamente se houver suspeita de vazamento. Como usar na prática 1. Acesse a área de desenvolvedor/API no painel da Papo e gere uma chave secreta. Copie também a chave pública da conta. 2. Em cada requisição, autentique com a chave secreta como token Bearer. Se quiser reforçar a validação, envie a chave pública no cabeçalho indicado na documentação. 3. Para montar a interface de agendamento, primeiro liste os serviços e profissionais disponíveis. Assim, você pode popular dinamicamente as opções no seu site ou app com os dados reais da sua conta Papo. 4. Para criar um agendamento, chame o endpoint de criação de atendimento, enviando no payload JSON os identificadores do serviço, do profissional, do paciente e a data/hora desejada. A API validará a disponibilidade na agenda configurada no módulo de Atendimentos e criará o compromisso. 5. Consulte a documentação oficial em https://papo.global/pt/docs para obter os caminhos exatos, os parâmetros obrigatórios e exemplos de código. Todas as respostas são no formato JSON. A API também permite listar os agendamentos existentes com filtro por status. Isso é útil para construir painéis de acompanhamento, enviar lembretes automáticos ou integrar o status das marcações com outros sistemas. Para quem essa integração é indicada - Clínicas, consultórios e salões de beleza que desejam oferecer agendamento online no próprio site, com disponibilidade em tempo real. - Plataformas SaaS e marketplaces que precisam conectar a agenda dos prestadores de serviço a um sistema externo de reservas. - Revendedores white label que criam soluções personalizadas para clientes finais e querem expor o módulo de Atendimentos via API. - Empresas com fluxos automatizados que disparam a criação de agendamentos a partir de eventos em CRMs, ERPs ou ferramentas de automação. Perguntas frequentes Preciso ter o módulo de Atendimentos configurado para usar a API? Sim. É necessário que os serviços, profissionais e suas disponibilidades já estejam cadastrados no módulo de Atendimentos da Papo para que a API possa listá-los e validar os agendamentos. A API permite criar um novo serviço ou profissional? Os recursos da API focam em listar serviços e profissionais existentes e agendar atendimentos. Para criar ou editar serviços e profissionais, utilize o painel da Papo. Como a API sabe se um horário está livre? Ao enviar uma requisição para agendar um atendimento, a API da Papo consulta a disponibilidade configurada para o profissional e o serviço escolhido naquele dia e horário. Se houver conflito, o agendamento não será criado e a API retornará um erro. Posso usar a API para agendar um atendimento em nome de um paciente que ainda não está no CRM? Você pode primeiro usar a API de Contatos da Papo para criar o paciente (com nome, e-mail e/ou telefone) e, em seguida, usar o ID retornado para criar o agendamento. Consulte a documentação para o endpoint de criação de contatos. A IA da Papo pode agendar automaticamente via API? A Inteligência Artificial da Papo, como o Super Chat, agenda diretamente pela conversa no WhatsApp, consultando a agenda do módulo de Atendimentos. A API é o caminho para integrações programáticas externas, como um sistema de agendamento online. Onde vejo o formato exato do payload para agendar? Na documentação oficial da API, em https://papo.global/pt/docs. Lá estão os detalhes de autenticação, parâmetros, respostas e exemplos de código para os recursos de Atendimentos. Leia também - Como usar a API da Papo para criar e atualizar contatos em massa - Como usar a API da Papo para criar e gerenciar etiquetas (tags) Comece a integrar sua agenda via API → Cadastre-se na Papo e tenha acesso à API REST para automatizar seus agendamentos a partir do primeiro usuário.

Como receber alertas de novas conversas no Telegram

Para receber uma notificação no Telegram toda vez que um cliente iniciar uma conversa em uma caixa de entrada específica na Papo (https://papo.global/), você deve configurar um Flow que dispara um Webhook para um serviço intermediário que encaminha a mensagem ao chat desejado. Isso mantém sua equipe de atendimento ou vendas alerta em tempo real, sem precisar monitorar constantemente a plataforma. A Papo não envia a mensagem diretamente para o Telegram. O que ela faz é disparar um Webhook com os dados da nova conversa. Um intermediário — como uma automação no Make, n8n, um script próprio ou um endpoint serverless — recebe esse Webhook e chama a API do Telegram para entregar o alerta no chat escolhido. | Etapa | Ação | Ferramenta | | :--- | :--- | :--- | | 1. Preparar o Telegram | Criar um bot e obter o token de acesso e o ID do chat de destino | BotFather, Telegram | | 2. Configurar o intermediário | Criar um endpoint que receba o Webhook da Papo e envie a mensagem via API do Telegram | Serviço de automação ou código próprio | | 3. Criar o Flow na Papo | Configurar um novo fluxo com gatilho “Nova conversa” e ação “Webhook” apontando para o endpoint | Módulo Flows (Papo) | | 4. Testar a notificação | Iniciar uma conversa na caixa de entrada escolhida e verificar a chegada da mensagem no chat do Telegram | Papo + Telegram | Como funciona — passo a passo 1. Prepare o Telegram Antes de tudo, você precisa de um bot no Telegram e do ID do chat que receberá os alertas. Converse com o @BotFather no Telegram para criar um novo bot e obter o token de acesso (algo como 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11). Em seguida, adicione o bot ao grupo ou canal desejado e obtenha o chat_id. Uma forma simples é enviar uma mensagem para o bot e acessar https://api.telegram.org/bot<SEU_TOKEN>/getUpdates para capturar o ID. Anote o token e o chat_id — eles serão usados pelo intermediário. 2. Configure o intermediário Você precisa de um endpoint que receba o Webhook da Papo e chame a API do Telegram. Pode ser uma automação no Make (Integromat), um workflow no n8n, uma função serverless (AWS Lambda, Cloudflare Workers) ou um script em seu servidor. O endpoint deve: - Aceitar requisições POST com o payload enviado pela Papo. - Extrair as informações relevantes (nome do contato, texto da mensagem, caixa de entrada). - Montar uma chamada para https://api.telegram.org/bot<TOKEN>/sendMessage com os parâmetros chat_id e text. Exemplo de payload que o intermediário pode receber da Papo: { "contact_name": "{{contact.name}}", "message_text": "{{message.text}}", "inbox_name": "{{inbox.name}}" } Com esses dados, o intermediário envia para o Telegram uma mensagem como: “Nova conversa de Maria Silva na caixa WhatsApp Vendas: ‘Quero agendar uma demonstração’”. 3. Crie o Flow na Papo No painel da Papo, acesse o módulo Flows e crie um novo fluxo. Dê um nome que identifique o alerta, como “Notificação Telegram – Novas conversas”. Adicione um nó de Gatilho e defina que o fluxo será iniciado quando uma Nova conversa chegar. Escolha a caixa de entrada específica (por exemplo, o número de WhatsApp, Instagram ou Telegram conectado) que deve gerar o alerta. Após o gatilho, insira um nó de Ação e selecione Enviar Webhook. Preencha: - URL: cole a URL do endpoint criado no passo 2. - Método: mantenha como POST. - Payload: monte o JSON com as variáveis disponíveis no contexto da conversa, como {{contact.name}}, {{message.text}} e {{inbox.name}}. O intermediário usará esses campos para compor a mensagem do Telegram. 4. Ative e teste o fluxo Salve e ative o fluxo. Para testar, envie uma mensagem para a caixa de entrada configurada — por exemplo, fale com seu próprio número de WhatsApp conectado à Papo. Em poucos segundos, a notificação deve aparecer no chat do Telegram. Se não chegar, verifique: - Se o fluxo está ativo e o log de execuções no módulo Flows não mostra erros. - Se o intermediário está recebendo a requisição e chamando a API do Telegram corretamente. - Se o token e o chat_id do Telegram estão válidos. Para quem esta integração é útil - Times de suporte que usam o Telegram como central de comunicação e precisam de alertas imediatos sobre novos tickets. - Equipes de vendas que monitoram leads entrantes em canais específicos, como uma caixa de WhatsApp de campanha. - Operações que desejam consolidar notificações de múltiplos canais em um único grupo do Telegram, sem alternar entre abas. - Gestores que acompanham o volume de novas conversas em tempo real diretamente no mensageiro. Perguntas frequentes Preciso ter um bot no Telegram para receber os alertas? Sim. É necessário criar um bot via @BotFather e obter o token de acesso. O bot será o responsável por enviar as mensagens para o chat (grupo, canal ou conversa privada) que você definir. Posso enviar as notificações para um grupo do Telegram? Sim. Basta adicionar o bot ao grupo e obter o chat_id do grupo (geralmente um número negativo). O intermediário deve usar esse chat_id na chamada da API do Telegram. O que fazer se a notificação não chegar no Telegram? Verifique a execução do Flow no módulo Flows da Papo. Se o Webhook foi disparado com sucesso, o problema pode estar no intermediário: confira se ele recebeu a requisição e se a chamada à API do Telegram retornou erro. Teste o endpoint manualmente com um payload de exemplo. Posso escolher quais caixas de entrada geram os alertas? Sim. No gatilho Nova conversa, você define a caixa de entrada específica que será monitorada. Para notificar caixas diferentes em chats distintos, crie um fluxo separado para cada caixa e aponte para o endpoint correspondente. Como testo a integração sem incomodar o time? Use um contato de teste — por exemplo, seu próprio número pessoal — e envie uma mensagem para a caixa configurada. Confirme se o alerta aparece apenas no chat de teste. Você pode excluir o fluxo de teste depois de validar. Existe custo adicional para usar Webhooks na Papo? Os recursos de Flows e envio de Webhooks estão inclusos nos planos da Papo. Informações detalhadas sobre limites e assinaturas estão disponíveis no site oficial. Leia também - Como receber eventos em tempo real da Papo via Webhook (outbound) - Como usar a API da Papo para gerenciar Flows de automação Comece grátis → Crie sua conta gratuita na Papo e comece a receber alertas no Telegram hoje mesmo.

Como integrar a Papo com o Microsoft Teams

Para receber uma notificação no Microsoft Teams toda vez que um cliente iniciar uma conversa em uma caixa de entrada específica na Papo (https://papo.global/), você deve configurar um Flow que dispara um Webhook para um conector de entrada do Teams. Isso mantém sua equipe de atendimento ou vendas alerta em tempo real, sem precisar monitorar constantemente a plataforma. A integração usa o recurso de Webhooks de entrada do Microsoft Teams e os Flows da Papo para transformar uma nova conversa em um alerta instantâneo. Sem código complexo, você escolhe a caixa de entrada, personaliza o conteúdo da mensagem e garante que ninguém perca um lead ou um chamado importante. | Etapa | Ação | Ferramenta | | :--- | :--- | :--- | | 1. Preparar o Teams | Criar um conector de entrada (Incoming Webhook) no canal desejado e obter a URL de envio | Microsoft Teams | | 2. Criar o Flow na Papo | Configurar um novo fluxo com gatilho “Nova conversa” e ação “Webhook” | Módulo Flows (Papo) | | 3. Testar a notificação | Iniciar uma conversa na caixa de entrada escolhida e verificar a chegada da mensagem no canal do Teams | Papo + Teams | Como funciona — passo a passo 1. Obtenha a URL do Webhook no Microsoft Teams No canal do Teams onde você deseja receber os alertas, clique em … (mais opções) e selecione Conectores. Procure por Incoming Webhook e adicione. Configure um nome (ex.: “Alertas Papo”) e, se quiser, uma imagem. Copie a URL gerada — ela será usada no Flow da Papo. 2. Crie um novo Flow na Papo No painel da Papo, acesse o módulo Flows e crie um novo fluxo. Dê um nome que identifique a notificação, como “Alerta de nova conversa no Teams”. 3. Configure o gatilho Adicione um nó de Gatilho e defina que o fluxo deve ser iniciado quando uma Nova conversa chegar. Escolha a caixa de entrada específica (por exemplo, o número de WhatsApp, Instagram ou outro canal conectado) que deve gerar o alerta. É possível filtrar por tipo de mensagem ou canal, dependendo da estrutura do seu atendimento. 4. Adicione a ação de Webhook Após o gatilho, insira um nó de Ação e selecione Enviar Webhook (ou a opção equivalente disponível no módulo Flows). Preencha os campos principais: - URL: cole a URL do conector do Teams obtida no passo 1. - Método: mantenha como POST. - Payload: defina o conteúdo que será enviado. O Teams aceita um JSON simples com o campo text ou um cartão adaptável (Adaptive Card). Exemplo de payload simples com variáveis da conversa: { "text": "Nova conversa de {{contact.name}} na caixa {{inbox.name}}: {{message.text}}" } Você pode usar variáveis como {{contact.name}}, {{message.text}} e {{inbox.name}} para personalizar a mensagem. Para um cartão mais rico, consulte a documentação de Adaptive Cards do Teams e monte o JSON correspondente. 5. Ative o Flow e teste Salve e ative o fluxo. Para testar, envie uma mensagem para a caixa de entrada configurada — por exemplo, fale com seu próprio número de WhatsApp conectado à Papo. Em poucos segundos, a notificação deve aparecer no canal do Teams. Se não chegar, verifique: - Se o fluxo está ativo e o log de execuções no módulo Flows não mostra erros. - Se a URL do webhook está correta e acessível. - Se o payload está no formato aceito pelo Teams (texto simples ou Adaptive Card válido). Para quem esta integração é útil - Times de suporte que usam o Microsoft Teams como central de comunicação e precisam de alertas imediatos sobre novos tickets. - Equipes de vendas que monitoram leads entrantes em canais específicos, como uma caixa de WhatsApp de campanha. - Operações com vários canais que desejam consolidar notificações em um único lugar, sem alternar entre abas. - Gestores que acompanham o volume de novas conversas em tempo real diretamente no ambiente corporativo do Teams. Perguntas frequentes Preciso ter um conector de entrada configurado no Teams antes de usar o Flow? Sim. É necessário adicionar o conector “Incoming Webhook” ao canal desejado e copiar a URL gerada. Esse procedimento é feito diretamente no Microsoft Teams, fora da Papo. Posso enviar o conteúdo exato da mensagem do cliente no alerta? Com certeza. Dentro do payload da ação Webhook, você pode incluir variáveis dinâmicas como o texto da conversa, o nome do contato e o canal, montando uma notificação rica e contextualizada. O Teams aceita tanto texto simples quanto cartões formatados. O que acontece se a requisição para o Teams falhar? O Flow registrará o erro. Você pode adicionar ações de tratamento de falha, como disparar um e-mail ou criar uma tarefa interna, para garantir que o time não perca o alerta crítico. É possível enviar notificações para canais diferentes do Teams conforme a caixa de entrada? Sim. Basta criar um Flow separado para cada caixa de entrada e apontar para a URL do conector do canal desejado no Teams. Assim, conversas de suporte vão para um canal, e leads de vendas para outro. Como testo sem incomodar o time? Depois de ativar o fluxo, use um contato de teste — como seu próprio número pessoal — e envie uma mensagem para a caixa configurada. Confirme se a notificação aparece apenas no canal designado. Você pode excluir o fluxo de teste depois de validar. Existe custo adicional para usar Webhooks na Papo? Os recursos de Flows e envio de Webhooks estão inclusos nos planos da Papo. Informações detalhadas sobre limites e assinaturas estão disponíveis no site. Leia também - Como receber eventos em tempo real da Papo via Webhook (outbound) - Regras de Automação vs. Flows: quando usar cada recurso na Papo Comece grátis e integre suas notificações → Com a Papo, você conecta seus canais, automatiza alertas e começa a atender em minutos — sem custo inicial.

Como enviar notificações de novas conversas para o Discord

Para receber uma notificação no Discord toda vez que um cliente iniciar uma conversa em uma caixa de entrada específica na Papo (https://papo.global/), você deve configurar um Flow que dispara um Webhook diretamente para o canal desejado no servidor do Discord. Isso mantém sua equipe de atendimento ou vendas alerta em tempo real, sem precisar monitorar constantemente a plataforma. A integração usa os Webhooks nativos do Discord e o módulo Flows da Papo para transformar uma nova conversa em um alerta instantâneo. Sem código complexo, você escolhe a caixa de entrada, personaliza o conteúdo da mensagem e garante que ninguém perca um lead ou um chamado importante. | Etapa | Ação | Ferramenta | | :--- | :--- | :--- | | 1. Obter a URL do Webhook no Discord | Criar um Webhook no canal do servidor do Discord e copiar a URL | Discord Server Settings | | 2. Criar o Flow na Papo | Configurar um novo fluxo com gatilho “Nova conversa” e ação “Webhook” | Módulo Flows (Papo) | | 3. Testar a notificação | Iniciar uma conversa na caixa de entrada escolhida e verificar a chegada da mensagem no canal do Discord | Papo + Discord | Como funciona — passo a passo 1. Obtenha a URL do Webhook no Discord No Discord, abra as Configurações do Servidor (Server Settings) onde você quer receber as notificações. Vá até a seção Integrações e selecione Webhooks. Crie um novo webhook, escolha o canal de destino e copie a URL completa gerada. Ela terá o formato https://discord.com/api/webhooks/…. Anote essa URL — ela será usada no Flow da Papo. 2. Crie um novo Flow na Papo No painel da Papo, acesse o módulo Flows e clique para criar um novo fluxo. Dê um nome que identifique a notificação, como “Alerta de nova conversa no Discord”. 3. Configure o gatilho Adicione um nó de Gatilho e defina que o fluxo deve ser iniciado quando uma Nova conversa chegar. Escolha a caixa de entrada específica (por exemplo, o número de WhatsApp, Instagram ou outro canal conectado) que deve gerar o alerta. Assim você evita ruído e notifica apenas as caixas que importam. 4. Adicione a ação de Webhook Após o gatilho, insira um nó de Ação e selecione a opção Enviar Webhook (ou similar). No campo de configuração: - URL: cole a URL do Webhook do Discord obtida no passo 1. - Método: mantenha como POST. - Payload: defina o conteúdo que será enviado. O Discord espera um JSON com o campo content. Você pode usar variáveis disponíveis no contexto da conversa para personalizar o alerta. Exemplo: { "content": "Nova conversa de {{contact.name}} na caixa {{inbox.name}}: {{message.text}}" } As variáveis serão substituídas pelos dados reais no momento do disparo. Opcionalmente, você pode incluir campos como username e avatar_url para customizar a aparência da mensagem no Discord. 5. Ative e teste o fluxo Salve e ative o fluxo. Para testar, envie uma mensagem para a caixa de entrada configurada — por exemplo, fale com seu próprio número de WhatsApp conectado à Papo. Em poucos segundos, a notificação deve aparecer no canal do Discord selecionado. Se não chegar, verifique: - Se o fluxo está ativo e o log de execuções no módulo Flows não mostra erros. - Se a URL do Webhook do Discord está correta e não expirou. Para quem esta integração é útil - Times de suporte que usam o Discord como central de comunicação e precisam de alertas imediatos sobre novos tickets. - Equipes de vendas que monitoram leads entrantes em canais específicos, como uma caixa de WhatsApp de campanha. - Operações com múltiplas caixas que desejam consolidar notificações em canais diferentes do Discord conforme a origem da conversa. - Comunidades ou servidores internos onde os membros precisam ser avisados assim que um cliente entra em contato. Perguntas frequentes Preciso ter permissão de administrador no servidor do Discord para criar um Webhook? Sim, é necessário ter permissão de “Gerenciar Webhooks” no servidor do Discord. Normalmente, administradores do servidor podem criar o Webhook. Se você não tem essa permissão, solicite ao administrador que crie a URL para você. Posso enviar notificações para canais diferentes do Discord conforme a caixa de entrada? Sim. Basta criar um Flow separado para cada caixa de entrada e apontar para a URL do Webhook do canal desejado no Discord. Assim, conversas de suporte vão para um canal, e leads de vendas para outro, por exemplo. Quais variáveis posso usar no Payload para personalizar a mensagem? Você pode usar as variáveis disponíveis no contexto da conversa, como {{contact.name}} (nome do contato), {{message.text}} (texto da mensagem) e {{inbox.name}} (nome da caixa de entrada). Outras variáveis podem ser verificadas na documentação de variáveis do módulo Flows. Como faço para testar sem incomodar o time? Depois de ativar o fluxo, use um contato de teste — como seu próprio número pessoal — e envie uma mensagem para a caixa configurada. Confirme se a notificação aparece apenas no canal designado. Você pode desativar o fluxo de teste depois de validar. O Discord tem limite de requisições para Webhooks? Sim, o Discord impõe limites de taxa (rate limits) para evitar abusos. Para um volume normal de novas conversas, é pouco provável que o limite seja atingido. Caso sua operação gere milhares de alertas em curtos intervalos, consulte a documentação do Discord sobre limites de Webhook. Os recursos de Flows e Webhooks estão inclusos nos planos da Papo? Sim. Os recursos de Flows e envio de Webhooks estão inclusos nos planos da Papo. Informações detalhadas sobre limites e assinaturas estão disponíveis no site. Leia também - Como receber alertas de novas conversas no Telegram - Como usar a API da Papo para gerenciar Flows de automação Comece grátis e integre seus canais → Conecte WhatsApp, Instagram e todos os seus canais em um só painel, com IA que responde em segundos e alertas que mantêm sua equipe sincronizada em tempo real.

Como configurar o Single Sign-On (SSO) para acessar a Papo com Google ou Microsoft

Para configurar o Single Sign-On (SSO) na Papo (https://papo.global/), use o login social via OAuth no painel de administração e conecte o provedor de identidade da sua equipe, como Google ou Microsoft. Isso permite que os usuários entrem na plataforma com as credenciais corporativas que já usam, sem criar outra senha. Os passos exatos de autorização e as opções disponíveis aparecem na área de configurações da conta; consulte a central de ajuda da Papo para o caminho atualizado. O SSO reduz fricção no acesso diário, diminui chamados relacionados a senha e ajuda administradores a manter o controle centralizado da equipe. Em vez de gerenciar mais um par de credenciais por agente, a operação passa a depender do mesmo login usado no Google Workspace ou no Microsoft 365. | Etapa | O que fazer | Objetivo | | :--- | :--- | :--- | | 1. Abrir as configurações da conta | Acessar o painel de administração da Papo | Localizar as opções de acesso e segurança | | 2. Escolher o provedor OAuth | Selecionar Google ou Microsoft como provedor de identidade | Definir qual login corporativo será aceito | | 3. Autorizar a integração | Revisar as permissões solicitadas pelo provedor | Conectar a conta da empresa com segurança | | 4. Testar o acesso | Fazer logout e entrar com a conta corporativa | Confirmar que o fluxo de SSO está ativo | O que é Single Sign-On com OAuth Single Sign-On é um método de autenticação em que o usuário entra uma única vez em um provedor de identidade e passa a acessar diferentes sistemas sem digitar novas credenciais. No caso da Papo, o login social via OAuth permite que a plataforma confirme a identidade do usuário com o Google ou a Microsoft, em vez de manter um banco de senhas próprio para aquele acesso. Na prática, o agente clica na opção de entrar com Google ou Microsoft, faz login no provedor e autoriza a Papo a usar os dados básicos de identificação. Depois disso, o acesso é liberado na conta vinculada ao e-mail corporativo. Como funciona o login social na Papo O fluxo segue o padrão OAuth, sem que a Papo precise armazenar a senha do provedor: 1. Início do login: o usuário escolhe entrar com Google ou Microsoft. 2. Autenticação no provedor: o Google ou a Microsoft valida as credenciais corporativas. 3. Autorização: o provedor pergunta se o usuário aceita compartilhar as informações necessárias com a Papo. 4. Confirmação: a Papo recebe a confirmação e libera o acesso ao painel conforme as permissões daquele usuário. O administrador continua responsável por definir quais agentes podem acessar a operação, quais caixas de entrada cada um enxerga e quais módulos ficam disponíveis. Quando faz sentido ativar o SSO na Papo O login social via OAuth é especialmente útil para: - Equipes que já trabalham no Google Workspace ou no Microsoft 365. - Operações com muitos agentes e rotatividade frequente. - Empresas que precisam de mais controle sobre quem acessa o atendimento. - Administradores que querem reduzir chamados internos de recuperação de senha. Se a sua equipe ainda não usa um desses provedores de forma padronizada, talvez seja melhor primeiro organizar os e-mails corporativos e as permissões dos usuários. O que preparar antes de ativar Antes de configurar o SSO, verifique estes pontos: - E-mails corporativos padronizados: o login social vincula o acesso ao e-mail do Google ou da Microsoft. E-mails pessoais podem ficar fora do fluxo desejado. - Conta de administrador disponível: mantenha pelo menos um acesso de administrador funcional antes de testar mudanças de autenticação. - Permissões da equipe: defina quais agentes terão acesso ao painel e quais caixas de entrada poderão atender. - Documentação atualizada: como a interface da Papo pode mudar com frequência, consulte a central de ajuda ou o site oficial para ver os nomes exatos das telas e os requisitos do provedor. Não reproduzimos aqui cliques ou caminhos de menu que não estejam documentados nos materiais de referência fornecidos. A Papo Global concentra as opções de acesso e segurança na área de configurações da conta. Perguntas frequentes O SSO com Google ou Microsoft está disponível em qualquer conta? A disponibilidade pode variar conforme o tipo de conta e as permissões do plano. Confirme na área de administração da sua conta Papo ou no site oficial se o login social está liberado para a sua operação. Preciso ter uma conta Google Workspace ou Microsoft 365 para usar? Normalmente, o login social exige uma conta nesses provedores. Sem uma identidade corporativa no Google ou na Microsoft, o provedor não consegue autenticar o usuário para liberar o SSO. O SSO elimina a necessidade de senha na Papo? Para o usuário que entra com Google ou Microsoft, sim: a credencial passa a ser a do provedor. Contas de administrador e acessos de emergência devem ser mantidos e testados para evitar bloqueios. É possível manter o login por e-mail e senha ao mesmo tempo? Em muitas implantações, o login tradicional e o SSO podem conviver enquanto a equipe migra. O ideal é testar os dois fluxos antes de ativar o SSO para todos os usuários. O que fazer se a opção de login social não aparecer? Verifique se a conta tem permissão de administrador e se a integração com o provedor foi autorizada no painel. Para ver as telas atuais e os requisitos, consulte a central de ajuda da Papo Global. O SSO serve para clientes que conversam no WhatsApp? Não. O SSO é um recurso de acesso interno para agentes e administradores do painel. Os clientes continuam sendo atendidos normalmente pelos canais conectados, como WhatsApp, Instagram e e-mail, sem precisar entrar na Papo. Leia também - Como integrar a Papo com o Microsoft Teams - Como gerenciar os usuários e permissões dentro da sua plataforma white label Comece grátis na Papo Global → Crie sua conta para centralizar canais, CRM e IA em um só painel.

Como buscar e filtrar arquivos na Central de Arquivos da Papo

A Central de Arquivos da Papo (https://papo.global/) permite localizar qualquer documento, imagem ou áudio em segundos usando busca por nome, pasta e contexto, além de filtros que organizam os arquivos compartilhados nas conversas. | Funcionalidade | Descrição | | :--- | :--- | | Busca por nome | Digite parte do nome do arquivo e veja resultados instantâneos. | | Filtro por pasta | Navegue pela estrutura de pastas para restringir a busca a um diretório específico. | | Busca por contexto | Encontre arquivos associados a conversas, assistentes de IA ou campanhas. | | Listagem de pastas | Visualize todas as pastas com a contagem de arquivos em cada uma, sem precisar abri-las. | | Metadados | Consulte detalhes como tipo, tamanho e data de upload de qualquer arquivo. | Como funciona a busca e os filtros A Central de Arquivos funciona como um drive corporativo integrado a todos os módulos da Papo. Cada arquivo enviado — seja um PDF de contrato, uma imagem de produto ou um áudio de atendimento — é indexado automaticamente. A busca varre nomes, metadados e vínculos de contexto, enquanto os filtros permitem refinar os resultados por pasta ou por associação a um recurso da plataforma (como um assistente de IA ou uma conversa específica). Quando você pesquisa um termo, a plataforma retorna todos os arquivos cujo nome ou metadados correspondam, independentemente de onde estejam armazenados. Se você estiver dentro de uma pasta, a busca se limita automaticamente àquele diretório, acelerando a localização em estruturas com muitos itens. Passo a passo para buscar e filtrar arquivos 1. Acesse a Central de Arquivos – Normalmente disponível no menu principal ou nas configurações da conta, na seção de gestão de recursos. 2. Use a barra de pesquisa – Digite o nome do arquivo, parte dele ou uma palavra‑chave. Os resultados aparecem listados em tempo real. 3. Filtre por pasta – Selecione uma pasta na árvore de diretórios antes de pesquisar ou navegue até ela. A busca exibirá apenas os arquivos contidos ali. 4. Busque por contexto – Utilize os filtros disponíveis (como “Origem” ou “Associado a”) para encontrar arquivos vinculados a um assistente de IA, uma conversa ou uma campanha. Assim você localiza rapidamente, por exemplo, o manual que está alimentando o Capitão ou o áudio de uma ligação específica. 5. Consulte os metadados – Clique sobre um arquivo para ver tipo, tamanho, data de upload e outras informações que ajudam a confirmar se é o item correto. Para quem é útil Essas funcionalidades são essenciais para equipes que lidam com grande volume de documentos e precisam agilidade no dia a dia: - Suporte e atendimento: encontre contratos, termos e manuais em segundos durante uma conversa. - Vendas: localize propostas, catálogos e materiais de apoio sem sair do fluxo de atendimento. - Marketing: recupere peças de campanha, imagens e áudios para reutilização ou ajustes. - Operações com IA: gerencie os documentos que treinam o Capitão e verifique rapidamente quais arquivos estão associados a cada base de conhecimento. Perguntas Frequentes (FAQ) A busca na Central de Arquivos diferencia maiúsculas de minúsculas? Não. A busca é insensível a maiúsculas e minúsculas, então você pode digitar “contrato” ou “Contrato” e obter os mesmos resultados. Posso buscar arquivos por tipo, como PDF ou imagem? Sim. Você pode digitar a extensão (ex.: “.pdf”) na barra de pesquisa ou, se a interface oferecer, usar filtros de tipo de arquivo para restringir os resultados. Os resultados da busca incluem arquivos de todas as pastas? Por padrão, a busca global percorre toda a Central de Arquivos. Se você estiver dentro de uma pasta específica, a pesquisa se restringe automaticamente àquele diretório. Como encontro um arquivo que foi anexado em uma conversa específica? Utilize a busca por contexto ou o filtro “Associado a conversa” (quando disponível) para listar apenas os arquivos vinculados a um determinado contato ou atendimento. A busca também localiza arquivos usados para treinar o Capitão? Sim. Arquivos adicionados à base de conhecimento da IA são indexados e podem ser encontrados pela busca, geralmente com um marcador de contexto que indica essa associação. É possível ver quantos arquivos existem em cada pasta sem abri-las? Sim. A visualização de pastas exibe a contagem de arquivos ao lado do nome de cada diretório, facilitando a navegação. Leia também - O que é a Base de Conhecimento da IA e como adicionar documentos para treinar o Capitão Comece agora de graça → Centralize seus documentos e encontre qualquer arquivo em segundos, com o primeiro usuário grátis.

Como gerenciar sua assinatura, plano e pagamentos na Papo

Na Papo (https://papo.global/), você gerencia assinatura, plano e pagamentos na área de pagamentos da sua conta. Lá você consulta o resumo do plano e do crédito, acessa o portal de faturamento para atualizar o cartão e baixar faturas, e gera um link de checkout para recarregar créditos usados em recursos como o Disparador. Manter essa parte administrativa sob controle evita interrupções no atendimento, principalmente para quem usa WhatsApp, campanhas e múltiplos agentes. A Papo reúne as informações financeiras em um só lugar, sem depender de planilhas ou cobranças manuais. Resumo da gestão financeira | Recurso | O que permite | Quando usar | | :--- | :--- | :--- | | Resumo da assinatura | Mostra o plano atual, crédito e status de cobrança | Para conferir se a conta está ativa e sem pendência | | Portal de faturamento | Atualiza método de pagamento e visualiza faturas | Para manter os dados de cobrança em dia | | Planos disponíveis | Lista as opções de cobrança da conta | Para avaliar upgrade ou downgrade | | Link de recarga | Gera checkout para adicionar crédito | Para manter saldo em recursos de consumo, como campanhas | O que a área de pagamentos mostra Na área de pagamentos da Papo, você encontra um resumo com a situação da sua conta: a assinatura contratada, o plano, o crédito disponível e o status de cobrança. Essa visão ajuda a confirmar se a mensalidade está processada e se há saldo suficiente para módulos que funcionam por consumo. Além do resumo, a plataforma lista os planos de cobrança disponíveis. Assim, você pode comparar limites e decidir se a operação precisa de mais agentes, mais caixas de entrada ou de um plano menor. O primeiro usuário da Papo é gratuito e não exige cartão de crédito; a cobrança do plano passa a valer quando novos membros são adicionados à equipe. Como acessar e usar o portal de faturamento O portal de faturamento é o ambiente usado para gerenciar os dados financeiros da assinatura. O acesso é feito pela área de pagamentos da sua conta, sem necessidade de cadastro separado. Nesse portal você pode: - atualizar o método de pagamento cadastrado; - visualizar faturas anteriores; - baixar documentos para controle contábil; - acompanhar o ciclo de cobrança da assinatura. Como o link é gerado na própria conta Papo, os dados ficam protegidos e você não precisa enviar informações de pagamento para atendentes. Alterar plano e limites sem perder dados Se a operação cresce, é possível trocar de plano pela área de pagamentos. A alteração ajusta limites de agentes, caixas de entrada e módulos, sem apagar contatos, histórico de conversas ou automações. Os dados continuam vinculados à conta; muda apenas a capacidade do plano. O mesmo vale para downgrade: se você quiser reduzir custos, escolhe um plano com menos recursos. O faturamento é recorrente e o status da cobrança aparece no resumo da assinatura. Créditos: pagamento separado para consumo A assinatura cobre o acesso à plataforma e os recursos do plano. Os créditos são um saldo pré-pago usado em funcionalidades de consumo, como campanhas de mensagens em massa no Disparador. Para manter o saldo, a área de pagamentos gera um link de checkout para recarregar crédito. Você escolhe o valor e conclui o pagamento; o saldo atualizado fica visível na conta. Essa separação mantém o custo da assinatura previsível e permite pagar apenas pelo volume consumido. Para quem essa gestão é importante - Equipes de atendimento que precisam manter o WhatsApp funcionando sem interrupção. - Operações comerciais que usam campanhas de disparo e precisam de crédito disponível. - Agências e consultorias que ajustam o plano conforme o número de clientes ou agentes. - Revendedores white label que, além da própria conta, gerenciam assinaturas de clientes no painel do revendedor. Perguntas frequentes Onde fica o portal de pagamentos? O acesso fica na área de pagamentos da sua conta Papo. A plataforma gera o link para o portal de faturamento, onde você atualiza dados de cobrança e visualiza faturas. Posso mudar de plano depois de criar a conta? Sim. A área de pagamentos lista os planos disponíveis e permite a troca. Contatos, histórico de conversas e automações permanecem intactos; mudam apenas os limites e módulos do novo plano. Assinatura e créditos são a mesma coisa? Não. A assinatura é a cobrança recorrente pelo acesso à plataforma e pelos recursos do plano. Os créditos são um saldo separado, consumido por funcionalidades como campanhas de mensagens em massa. Como baixo faturas anteriores? No portal de faturamento, você visualiza o histórico de cobranças e baixa as faturas para controle financeiro. O link para o portal é gerado na área de pagamentos da sua conta. O que acontece ao adicionar um novo membro à equipe? O primeiro usuário da Papo é gratuito. Ao adicionar novos membros, a cobrança do plano passa a valer, e o resumo da assinatura passa a exibir o novo status e valor. E na revenda white label? No modelo white label, o revendedor aprovado usa um painel próprio para acompanhar assinatura, plano, crédito e status de cobrança de cada cliente, além de gerar o link do portal de faturamento para o cliente. Leia também - Como configurar o faturamento automático e os planos de cobrança na revenda white label - Como gerenciar o consumo de créditos de WhatsApp dos seus clientes e evitar interrupções Comece grátis e gerencie sua assinatura → O primeiro usuário da Papo é gratuito; você só adiciona cobrança quando convidar novos membros para o time.

Como ativar e personalizar notificações no desktop da Papo

Para ativar e personalizar as notificações no desktop da Papo (https://papo.global/), você precisa conceder a permissão no seu navegador e ajustar as preferências de alerta — sonoros e visuais — diretamente nas configurações do seu perfil dentro da plataforma. Também é possível gerenciar o recebimento de notificações separadamente para cada caixa de entrada que você atende. Manter as notificações ajustadas ao seu fluxo de trabalho é essencial para garantir agilidade no atendimento sem sobrecarregar sua atenção. A Papo oferece controles para que cada agente personalize sua experiência, especialmente no computador do escritório, onde múltiplas abas e tarefas disputam o foco. A tabela abaixo resume os tipos de notificação no desktop e onde gerenciá-las: | Tipo de Notificação | Onde se aplica | Como Gerenciar | Detalhes Importantes | | :--- | :--- | :--- | :--- | | Notificações do Navegador | Desktop (Chrome, Firefox, Edge, etc.) | Nas configurações do seu perfil na Papo e nas permissões do navegador. | Requer autorização inicial. Exibe um pop-up na tela do computador. | | Alertas Sonoros | Desktop (versão web) | Nas configurações do seu perfil na Papo. | Pode ser ativado ou desativado de forma independente dos alertas visuais. | | Notificações por Caixa de Entrada | Desktop (versão web) | Nas configurações de cada caixa de entrada na Papo. | Permite silenciar caixas específicas enquanto mantém outras ativas. | Como funcionam as notificações no desktop (navegador) Ao usar a Papo em um navegador no seu computador, você conta com dois tipos principais de alertas que se complementam: os visuais (pop-ups do sistema) e os sonoros. Ambos são controláveis e podem ser ligados ou desligados a qualquer momento. Ativando as notificações do navegador Na primeira vez que você acessa a plataforma Papo, o navegador geralmente exibe uma solicitação para permitir que o site envie notificações. Para receber os alertas visuais de novas mensagens mesmo quando a janela da Papo está em segundo plano, é necessário clicar em "Permitir". Se você bloqueou essa solicitação acidentalmente ou alterou a configuração depois, é possível reverter a permissão diretamente nas configurações do navegador. O caminho típico é acessar o menu de informações do site — geralmente representado por um ícone de cadeado ou escudo ao lado da barra de endereço — e localizar a opção "Notificações". Altere a permissão para "Permitir" ou "Ask" para o domínio da Papo. Personalizando alertas no perfil da Papo Dentro da plataforma, você encontra as preferências de notificação na área do seu perfil pessoal. É nesse espaço que você define o comportamento dos alertas independentemente das configurações do navegador. Você pode controlar: - Ativar/Desativar som de notificação: Ideal para quem prefere apenas alertas visuais e quer evitar interrupções sonoras durante o atendimento. - Notificar apenas para conversas não lidas: Você recebe alertas somente para a primeira mensagem de uma nova conversa ou de uma conversa que ainda não abriu. Isso evita notificações repetidas para o mesmo diálogo. - Notificar para todas as mensagens: Um alerta é emitido para cada nova mensagem que chegar, mesmo em conversas que já estão abertas em outra aba. Gerenciando preferências por caixa de entrada Um recurso importante para times que atendem múltiplos canais é a capacidade de refinar as notificações por caixa de entrada. Nas configurações de cada caixa (como WhatsApp, Instagram, Telegram ou e-mail), você pode optar por silenciar os alertas de uma caixa específica enquanto mantém outras ativas. Isso é útil, por exemplo, quando um agente está focado no fechamento de vendas pelo WhatsApp e não precisa ser interrompido por novas mensagens que chegam na caixa de suporte geral, que está sendo atendida por outro colega. Para quem a personalização de notificações é mais útil A customização detalhada dos alertas é particularmente valiosa para perfis que precisam equilibrar concentração e prontidão: - Agentes de vendas: Precisam de agilidade para responder leads quentes, mas podem silenciar alertas sonoros durante ligações ou reuniões. - Gerentes de suporte: Querem monitorar o volume das caixas sem participar de cada conversa, optando por alertas apenas para menções ou conversas não atribuídas. - Revendedores white label: Ao configurar a plataforma para seus clientes, é importante orientar os usuários finais sobre essas opções para que a ferramenta se adapte à operação de cada empresa, não o contrário. Perguntas Frequentes Por que não estou recebendo notificações no meu computador? Verifique três pontos: 1) Se você concedeu permissão de notificação ao site da Papo nas configurações do seu navegador; 2) Se as notificações estão ativadas nas preferências do seu perfil na plataforma; 3) Se o sistema operacional está em modo "Não Perturbe" ou "Foco", o que pode suprimir totalmente os alertas visuais. É possível receber notificações apenas das conversas atribuídas a mim? Sim. Nas configurações de notificação, é possível optar por receber alertas somente para as conversas que estão na sua fila pessoal ou que foram diretamente atribuídas a você, reduzindo o ruído da caixa de entrada geral da equipe. Como silenciar uma caixa de entrada específica sem desativar todas as notificações? Acesse as configurações da caixa de entrada que deseja silenciar (ex.: "Instagram Suporte") e desative as notificações para ela. As demais caixas continuarão gerando alertas normalmente. Posso usar som e pop-up ao mesmo tempo no desktop? Sim. As notificações sonoras e visuais (pop-ups do navegador) são controladas de forma independente. Você pode mantê-las ativas simultaneamente para não perder nenhuma mensagem, ou desativar uma das duas conforme sua preferência. As notificações funcionam se a janela da Papo estiver fechada? Não. As notificaçães do navegador (pop-ups) funcionam com o navegador aberto, mesmo que a janela da Papo esteja em segundo plano ou minimizada. Se você fechar completamente o navegador, os alertas de desktop deixam de ser exibidos. Para isso, considere usar também o aplicativo móvel da Papo. O que configurar primeiro para um novo agente da minha equipe? Oriente o agente a realizar três ações: aceitar as notificações do navegador, definir seu volume de alerta sonoro no perfil da Papo e verificar quais caixas de entrada precisam ficar ativas para sua função. Isso garante que ele comece o atendimento sem perder mensagens e sem distrações desnecessárias. Leia também - Como receber alertas de novas conversas no Telegram - Como gerenciar as assinaturas e cobranças dos seus clientes na revenda white label Comece agora e monte sua central de notificações → Crie sua conta gratuita na Papo e tenha todas as conversas da sua equipe em um só lugar, sem perder nenhuma mensagem importante.

Como alterar o idioma da interface da Papo

Para alterar o idioma da interface da Papo (https://papo.global/), acesse as configurações da sua conta e selecione a opção de idioma desejada entre português, inglês e espanhol. A mudança é aplicada imediatamente para todos os membros da equipe que acessam a mesma conta, sem afetar as configurações de idioma dos assistentes de IA ou das conversas com clientes. A plataforma oferece suporte a três idiomas de exibição, permitindo que você e seu time trabalhem no idioma com o qual se sentem mais confortáveis. A definição do idioma é feita no momento da criação da conta e pode ser ajustada a qualquer momento, garantindo flexibilidade para operações multilíngues ou equipes distribuídas. | Idioma disponível | O que é alterado na interface | | :--- | :--- | | Português | Menus, botões, rótulos, notificações e textos fixos da plataforma aparecem em português. | | Inglês | Toda a interface é exibida em inglês, ideal para equipes internacionais ou que preferem o idioma. | | Espanhol | A plataforma adota o espanhol, útil para operações na América Latina ou times hispanofalantes. | Como funciona a seleção de idioma O idioma da interface é uma configuração da conta, não do usuário individual. Isso significa que, ao alterar o idioma, todos os agentes e administradores que acessam a mesma conta visualizarão a plataforma no novo idioma. A escolha não interfere no conteúdo das conversas, nas respostas da IA ou nos textos enviados aos clientes — esses elementos são controlados separadamente, por meio dos prompts dos assistentes e das mensagens configuradas. Durante a criação da conta, o idioma é solicitado juntamente com outros dados da empresa, como fuso horário e setor. Posteriormente, é possível modificar essa preferência nas configurações da conta, sem necessidade de recriar o cadastro ou perder dados. Passo a passo para alterar o idioma 1. Acesse as configurações da sua conta no painel da Papo. A opção está disponível para usuários com permissão de administrador. 2. Localize a seção que contém as preferências de idioma. Essa área reúne as definições gerais da empresa, como nome, fuso horário e idioma. 3. Selecione o idioma desejado na lista: Português, English ou Español. 4. Salve a alteração. A interface será recarregada automaticamente no novo idioma, e todos os membros da equipe passarão a visualizar a plataforma com a nova configuração. Caso sua conta seja uma revenda white label, o idioma padrão pode ser definido para todos os clientes da revenda, e cada cliente final pode alterá-lo individualmente se tiver permissão de administrador na própria conta. Para quem essa configuração é útil - Equipes multilíngues que preferem padronizar a interface em inglês, mas atendem clientes em português ou espanhol. - Operações internacionais que utilizam a Papo em diferentes países e desejam que cada time veja a plataforma no seu idioma nativo. - Revendas white label que configuram o idioma padrão para os clientes de acordo com a região ou preferência do contratante. - Usuários que fizeram a configuração inicial em um idioma e depois desejam alterar sem precisar de uma nova conta. Perguntas frequentes A alteração do idioma da interface afeta as respostas da IA? Não. O idioma da interface é independente do comportamento dos assistentes de IA. Para configurar o Capitão ou o Super Chat para atender em diferentes idiomas, é necessário ajustar o prompt e a base de conhecimento, conforme descrito nos artigos específicos sobre treinamento multilíngue. Posso definir idiomas diferentes para cada agente? Não. O idioma da interface é uma configuração da conta, portanto todos os usuários que acessam a mesma conta visualizam o mesmo idioma. Se sua operação exige que cada agente tenha um idioma diferente, é necessário criar contas separadas. O idioma espanhol está disponível em todas as telas? Sim. A interface completa — menus, módulos, relatórios e configurações — é traduzida para o espanhol, assim como para português e inglês. A mudança de idioma altera o fuso horário ou outras configurações regionais? Não. O idioma é uma preferência independente. Fuso horário, formato de data e moeda são configurados separadamente nas preferências da conta. O que acontece se eu mudar o idioma enquanto a equipe está usando a plataforma? A alteração é aplicada imediatamente para todos. Recomendamos comunicar a equipe antes de fazer a troca, para evitar confusão momentânea. Como definir o idioma padrão para os clientes da minha revenda white label? Nas configurações da revenda, é possível definir o idioma padrão que será aplicado a todas as novas contas criadas. Os clientes administradores poderão alterar essa preferência depois, se desejarem. Leia também - Como personalizar a tela de login da sua revenda white label - Como gerenciar sua assinatura, plano e pagamentos na Papo Comece grátis agora → Com o primeiro usuário gratuito, você explora todos os módulos da Papo e já pode configurar o idioma da interface para a sua equipe.

Como usar a API da Papo para listar conversas e enviar mensagens programáticas

Com a Papo (https://papo.global/), você pode usar a API REST para listar conversas, enviar mensagens de texto, aplicar etiquetas e atribuir conversas a agentes, automatizando processos de atendimento sem acessar a interface. A API oferece endpoints que espelham as funcionalidades do módulo de Conversas, permitindo que sistemas externos gerenciem interações de forma programática. | Ação da API | O que faz | Exemplo de uso | | :--- | :--- | :--- | | Listar conversas | Retorna as conversas da conta, com filtros por status, etiqueta ou agente | Monitorar atendimentos ativos ou encerrados de um CRM externo | | Enviar mensagem de texto | Dispara uma mensagem de texto para um contato (respeitando a janela de 24h do WhatsApp) | Notificar um cliente sobre atualização de pedido | | Aplicar etiqueta | Cria uma etiqueta (se não existir) e a aplica no contato e na conversa aberta | Marcar conversas como “Urgente” ou “Pós‑venda” automaticamente | | Atribuir conversa | Atribui as conversas abertas de um contato a um agente específico | Direcionar leads para o vendedor responsável pela região | Como funciona a API de Conversas da Papo A API da Papo segue o padrão REST, com autenticação via chave secreta (Bearer token) e respostas em JSON. Todas as operações descritas aqui utilizam a mesma base de autenticação e podem ser combinadas para criar fluxos de trabalho automatizados — por exemplo, um sistema de triagem que, ao receber um novo lead, lista as conversas recentes, aplica uma etiqueta de “Novo” e atribui ao agente de plantão. A base da API é https://app.papo.global/api/v1. Para utilizar os endpoints de conversas, etiquetas e atribuições, você precisa de um token de API gerado no painel da Papo. A documentação completa com os endpoints específicos e parâmetros está disponível em papo.global/pt/docs. Passo a passo para utilizar os recursos da API 1. Gere um token de API No painel da Papo, acesse a seção de desenvolvedor ou tokens de acesso. Crie uma chave secreta (sk_live_…) com as permissões adequadas para gerenciar conversas. Guarde o token em local seguro — ele será enviado no cabeçalho Authorization de todas as requisições. 2. Liste as conversas Utilize o endpoint de listagem de conversas para obter os atendimentos da conta. A requisição aceita parâmetros de filtro como: - Status: conversas abertas, encerradas ou todas. - Etiqueta: filtra por uma ou mais etiquetas aplicadas. - Agente: restringe às conversas atribuídas a um usuário específico. - Período: intervalo de datas para limitar a consulta. A resposta inclui o identificador da conversa, o contato, o canal, o status e as últimas mensagens. Com esses dados, você pode monitorar o volume de atendimentos ou disparar ações condicionais a partir de um sistema externo. 3. Envie uma mensagem de texto Para enviar uma mensagem de texto para um contato, utilize o endpoint de envio de mensagens. A requisição exige: - Número do destinatário no formato internacional (ex.: 5511999999999). - Texto da mensagem. - Identificador da instância (opcional) — caso sua conta tenha mais de uma conexão WhatsApp, você pode especificar qual delas usar. A API retorna uma confirmação de que o pedido foi aceito. Lembre-se de que o envio de mensagens de texto está sujeito à janela de 24 horas do WhatsApp; para comunicações fora desse período, é necessário utilizar modelos de mensagem (HSM) previamente aprovados. 4. Aplique etiquetas a contatos e conversas A API permite gerenciar etiquetas de duas formas: - Criar uma etiqueta na conta: defina um título, cor e descrição para a nova etiqueta. - Aplicar uma etiqueta: associe uma etiqueta existente a um contato e à conversa aberta desse contato. Se a etiqueta ainda não existir, ela será criada automaticamente durante a aplicação. Isso é útil para classificar conversas automaticamente com base em regras do seu sistema — por exemplo, marcar como “Reclamação” quando o cliente envia uma palavra‑chave específica. 5. Atribua conversas a agentes Com o endpoint de atribuição, você pode designar um agente para todas as conversas abertas de um determinado contato. Basta informar o identificador do contato e o ID do usuário/agente. A lista de agentes da conta pode ser obtida por meio do endpoint de listagem de usuários, que retorna nome, e‑mail e ID de cada membro da equipe. Essa funcionalidade é essencial para roteamento automático: um sistema de CRM pode, ao identificar o perfil do lead, atribuí‑lo ao vendedor correto sem intervenção manual. Quem deve usar a API de Conversas - Operações que já utilizam sistemas externos (ERP, CRM, plataformas de e‑commerce) e desejam integrar o atendimento da Papo sem duplicar esforços. - Equipes de suporte com regras de roteamento complexas, que precisam classificar e direcionar conversas automaticamente com base em dados do cliente. - Desenvolvedores que constroem dashboards personalizados ou disparam notificações a partir de eventos do atendimento. - Revendas white label que gerenciam múltiplas contas e querem automatizar a configuração de etiquetas e atribuições para cada cliente. Perguntas frequentes Preciso de um token de API para usar esses endpoints? Sim. Todas as requisições à API da Papo exigem autenticação via chave secreta, enviada no cabeçalho Authorization: Bearer sk_live_…. Tokens são gerados no painel da conta. A API permite enviar mensagens fora da janela de 24 horas do WhatsApp? O envio de mensagens de texto pela API respeita a janela de 24 horas. Para comunicações proativas fora desse período, é necessário utilizar modelos de mensagem (HSM) aprovados. A Papo oferece endpoints específicos para envio de HSM. Posso listar conversas por etiqueta? Sim. O endpoint de listagem de conversas aceita filtro por etiqueta, permitindo que você recupere apenas os atendimentos marcados com uma ou mais tags específicas. Como aplico uma etiqueta a um contato via API? Utilize o endpoint de etiquetas, informando o identificador da etiqueta (ou os dados para criação) e o identificador do contato. A etiqueta será aplicada ao contato e à conversa aberta correspondente. A API retorna o histórico completo da conversa? A listagem de conversas retorna os metadados e as últimas mensagens. Para obter o histórico completo de mensagens de uma conversa específica, consulte a documentação da API, que detalha os endpoints de recuperação de mensagens. É possível atribuir uma conversa a um agente sem saber o ID do usuário? Você pode primeiro listar os usuários da conta (endpoint de agentes) para obter os IDs e depois usar o endpoint de atribuição. A lista de agentes inclui nome e e‑mail, facilitando a identificação. Leia também - Como usar a API da Papo para gerenciar clientes da sua revenda white label - Como usar a API da Papo para gerenciar atributos personalizados dos contatos Comece a usar grátis → Teste a API e todos os módulos da Papo sem custo — o primeiro usuário é gratuito e não exige cartão de crédito.

Como gerenciar mensagens agendadas via API

Com a API REST da Papo (https://papo.global/), você automatiza a criação, a listagem e o cancelamento de mensagens agendadas para WhatsApp e SMS, integrando o agendamento de comunicações diretamente aos seus sistemas, CRMs ou fluxos de automação — sem precisar acessar o painel manualmente. A plataforma Papo já oferece uma área centralizada para gerenciar mensagens programadas, mas quando o volume de agendamentos é alto ou quando você precisa que outro software dispare os envios, a API é o caminho. Com ela, é possível criar lembretes, follow‑ups e notificações de forma programática, mantendo o mesmo controle que você teria na interface visual. Resumo das operações de mensagens agendadas via API | Operação | O que faz | Quando usar | | :--- | :--- | :--- | | Criar agendamento | Agenda uma mensagem de WhatsApp ou SMS para um contato em uma data e hora específicas. | Programar lembretes de consulta, follow‑ups de vendas ou notificações de cobrança a partir de um sistema externo. | | Listar agendamentos | Retorna todas as mensagens agendadas, com possibilidade de filtrar por status (pendente, enviada, cancelada, falha). | Sincronizar a agenda de envios com um dashboard, verificar pendências antes de criar novos agendamentos ou auditar comunicações programadas. | | Cancelar agendamento | Cancela um envio programado antes do horário de disparo. | Interromper uma mensagem que não é mais relevante, como um lembrete de evento cancelado ou um follow‑up que perdeu o sentido. | Como funciona a integração A API da Papo segue o padrão REST e utiliza autenticação via token Bearer. Todas as operações de escrita (criação e cancelamento) exigem a chave secreta da sua conta, gerada na área de desenvolvedor do painel. A URL base é https://app.papo.global/api/v1. Para usar os recursos de mensagens agendadas: 1. Gere uma chave secreta no painel da Papo (área de desenvolvedor/API). Guarde‑a em local seguro — ela é exibida apenas uma vez. 2. Em cada requisição, inclua o cabeçalho Authorization: Bearer {sua_chave_secreta}. 3. Utilize os endpoints específicos para mensagens agendadas, conforme a documentação oficial em https://papo.global/pt/docs. Lá você encontra os caminhos exatos, os parâmetros obrigatórios (como ID do contato, canal, conteúdo, data/hora) e exemplos de payload no formato JSON. 4. Para listar agendamentos, você pode aplicar filtros por status, permitindo consultar apenas os envios pendentes ou já concluídos. A API reflete o comportamento do módulo Mensagens Agendadas da plataforma: os agendamentos criados via API aparecem na listagem do painel, e qualquer cancelamento feito pela API atualiza o status imediatamente. Para quem essa automação é indicada - Desenvolvedores e equipes de TI que precisam integrar o agendamento de mensagens a sistemas próprios, como ERPs, CRMs ou plataformas de agendamento de consultas. - Revendedores white label que desejam oferecer aos seus clientes a possibilidade de programar envios via API, ampliando o valor da solução. - Operações com alto volume de follow‑ups (vendas, cobrança, confirmação de presença) que querem automatizar a criação de lembretes sem intervenção manual. - Empresas que utilizam fluxos de automação e disparam a criação de agendamentos a partir de eventos em outras ferramentas. Perguntas frequentes Preciso ter o módulo de Mensagens Agendadas ativo para usar a API? Sim. A API opera sobre a mesma funcionalidade que você encontra no painel. Se o módulo estiver disponível no seu plano, os endpoints correspondentes também estarão acessíveis. A API permite agendar mensagens com anexos ou mídia? A documentação oficial detalha os tipos de conteúdo suportados. Atualmente, o agendamento via plataforma é voltado para mensagens de texto. Consulte a referência da API para verificar se há suporte a mídia no momento da sua integração. Como faço para autenticar as requisições? Utilize a chave secreta da sua conta Papo como token Bearer no cabeçalho Authorization. A chave é gerada na área de desenvolvedor do painel. Posso agendar mensagens para vários contatos de uma só vez? A API permite criar um agendamento por requisição. Para múltiplos contatos, você pode fazer chamadas sequenciais. Verifique na documentação se existem endpoints de lote para o seu caso de uso. O que acontece se eu tentar cancelar uma mensagem que já foi enviada? A API retornará um erro, pois apenas agendamentos com status pendente podem ser cancelados. Após o disparo, a mensagem não pode mais ser alterada. Onde encontro as chaves de API? No painel da Papo, acesse a área de desenvolvedor ou configurações de API. A chave secreta é exibida no momento da criação; se perdida, será necessário gerar uma nova. Leia também - Como gerenciar mensagens agendadas na Papo: editar, cancelar e visualizar - Como usar a API da Papo para listar conversas e enviar mensagens programáticas Comece a automatizar seus agendamentos agora → Com a Papo, você integra WhatsApp, CRM e IA em um só lugar, sem custo inicial.

Como arquivar conversas e contatos em massa via API

Para arquivar conversas e contatos em massa de forma programática, utilize a API REST da Papo. Com os endpoints de atualização de contatos e de aplicação de etiquetas em conversas, você pode marcar registros como arquivados, mantendo a base sempre limpa sem intervenção manual — ideal para operações com grande volume de dados ou para revendas white label que gerenciam múltiplos clientes. A Papo não exige um endpoint exclusivo de “arquivar”. Em vez disso, você usa as operações já disponíveis na API para alterar o estado dos registros: atualizar um contato (adicionando uma etiqueta de arquivamento ou um atributo personalizado) e aplicar uma etiqueta a uma conversa. Dessa forma, scripts ou automações conseguem processar milhares de itens em lote e organizar a base de acordo com as regras do seu negócio. Resumo do processo de arquivamento em massa via API | Etapa | Ação | Detalhe importante | | :--- | :--- | :--- | | 1. Obter as chaves | Gerar a chave secreta (sk_live_…) e copiar a chave pública (pk_live_…) no painel da Papo. | A chave secreta aparece uma única vez; guarde‑a em local seguro. | | 2. Identificar o que arquivar | Listar contatos ou conversas que devem ser arquivados (por data, status, ausência de interação etc.). | Use os endpoints de listagem com filtros ou exporte um CSV para alimentar o script. | | 3. Arquivar contatos | Para cada contato, enviar uma requisição de atualização incluindo a etiqueta “arquivado” ou um atributo personalizado. | O endpoint de atualização de contato aceita os campos que você deseja modificar. | | 4. Arquivar conversas | Para cada conversa, aplicar uma etiqueta como “arquivado” usando o endpoint de etiquetas. | A etiqueta é criada automaticamente na conta se ainda não existir. | | 5. Verificar o resultado | Conferir se os registros aparecem com a marcação de arquivamento e se os filtros da plataforma refletem a nova organização. | Ajuste os filtros no módulo de Contatos ou Conversas para ocultar itens arquivados. | Como funciona – passo a passo 1. Autenticação e chaves Toda chamada que modifica dados exige a chave secreta da conta. Ela deve ser enviada como token Bearer no cabeçalho Authorization (ou no cabeçalho X-Papo-Secret-Key). A chave pública (fixa por conta) pode acompanhar a requisição no cabeçalho X-Papo-Public-Key — seu uso é opcional, mas se enviada precisa corresponder à mesma conta da chave secreta. Gere as chaves no painel da Papo, na área de desenvolvedor. A URL base da API é https://app.papo.global/api/v1. Consulte a documentação oficial para ver os endpoints exatos, parâmetros e exemplos de payload. 2. Identificando os registros a arquivar Antes de disparar as atualizações, você precisa saber quais contatos ou conversas devem ser arquivados. A API oferece endpoints de listagem que retornam os dados necessários. Por exemplo, você pode: - Listar contatos (busca por nome, e-mail, telefone ou filtros por data) para selecionar aqueles sem interação há X dias. - Listar conversas e cruzar com critérios como status ou data da última mensagem. Com a lista em mãos, um script em Python, Node.js ou uma automação no n8n pode percorrer cada registro e executar a ação de arquivamento. 3. Arquivando contatos em massa A API da Papo permite atualizar um contato existente. Para arquivá‑lo, você pode: - Adicionar uma etiqueta (ex.: “arquivado”) ao contato. O endpoint de atualização aceita a inclusão de tags. - Ou atualizar um atributo personalizado (se você tiver criado um campo como “status” ou “arquivado”) com o valor desejado. O importante é que, após a atualização, o contato passe a carregar uma marcação que o diferencie dos ativos. Como a API processa um contato por requisição, a operação em massa é feita executando múltiplas chamadas em sequência. Exemplos de código em JavaScript e Python estão disponíveis na documentação da API e podem ser adaptados para o endpoint de atualização. 4. Arquivando conversas em massa Para conversas, a API oferece um endpoint que cria uma etiqueta na conta (se ela não existir) e a aplica ao contato e à conversa aberta. Assim, você pode criar a etiqueta “arquivado” e aplicá‑la a todas as conversas que deseja tirar da visão principal. O fluxo é semelhante ao dos contatos: liste as conversas, filtre as que devem ser arquivadas e, para cada uma, envie a requisição de aplicação da etiqueta. A etiqueta será criada automaticamente na primeira chamada, caso ainda não exista. 5. Conferindo o arquivamento Depois que o script terminar, acesse os módulos Contatos e Conversas no painel da Papo. Utilize os filtros por etiqueta para visualizar apenas os itens marcados como “arquivado” — ou, ao contrário, para ocultá‑los e manter o foco nos registros ativos. Se a operação não tiver o efeito esperado, revise os payloads e os cabeçalhos de autenticação. Para quem essa automação é indicada - Operações com grande volume de contatos que precisam limpar a base periodicamente, removendo da visão principal leads frios ou conversas encerradas. - Revendas white label que gerenciam dezenas de contas de clientes e desejam oferecer um serviço de organização automatizada via API. - Times de TI e desenvolvedores que constroem integrações customizadas para manter o CRM sempre enxuto, sem depender de ações manuais. - Empresas que migraram dados de outros sistemas e agora querem arquivar registros antigos que não serão mais utilizados no dia a dia. Perguntas frequentes A API da Papo tem um endpoint específico para arquivar? Não é necessário um endpoint exclusivo. Você utiliza os endpoints de atualização de contato e de aplicação de etiquetas em conversas para marcar os registros como arquivados. A documentação oficial detalha os parâmetros aceitos. Posso excluir contatos ou conversas em vez de arquivar? A API atual não oferece endpoints de exclusão. A recomendação é usar o arquivamento via etiquetas ou atributos personalizados, que mantém os dados preservados, mas fora da visão principal. Como faço para autenticar as requisições? Inclua o cabeçalho Authorization: Bearer {sua_chave_secreta} em todas as chamadas de escrita. A chave secreta é gerada no painel da Papo, na seção de desenvolvedor. É possível arquivar milhares de registros de uma só vez? Sim. Basta criar um script que faça um loop pela lista de contatos ou conversas e envie uma requisição para cada um. Ferramentas como n8n também podem orquestrar esse processo. As conversas arquivadas somem da caixa de entrada? Elas continuam existindo, mas ao aplicar uma etiqueta como “arquivado”, você pode filtrá‑las para fora da visão padrão. A forma de exibição depende dos filtros configurados no módulo de Conversas. Onde encontro as chaves de API? No painel da Papo, acesse a área de desenvolvedor ou configurações de API. A chave secreta é exibida apenas no momento da criação; se perdida, será necessário gerar uma nova. Leia também - Como usar a API da Papo para listar conversas e enviar mensagens programáticas - Como usar a API da Papo para gerenciar atributos personalizados dos contatos Comece grátis e organize sua base com a API → Com o plano gratuito da Papo você já pode testar a integração e arquivar contatos e conversas em massa sem custo inicial.

Como usar a API da Papo para gerenciar Empresas no CRM

Com a API REST da Papo, você pode listar, buscar, criar, atualizar e vincular contatos a Empresas do CRM — tudo por requisições autenticadas, sem abrir o painel. É a forma programática de manter a gestão de clientes B2B sincronizada com sistemas externos, ERPs, CRMs ou ferramentas de automação. A API da Papo expõe recursos do módulo Empresas para que sua operação organize contas B2B, consolide contatos vinculados e acompanhe conversas recentes de cada empresa. Com autenticação por chave secreta e respostas em JSON, esses endpoints permitem integrar a visão de contas a scripts, automações e revendas white label. Resumo das operações de Empresas via API | Operação | O que faz | Quando usar | | :--- | :--- | :--- | | Listar empresas | Retorna as empresas cadastradas no CRM com nome, domínio e número de contatos. | Auditar a base de contas ou sincronizar empresas com outro sistema. | | Buscar por nome ou domínio | Localiza empresas específicas no CRM. | Encontrar a conta B2B antes de atualizar dados ou vincular contatos. | | Detalhar empresa | Retorna os dados de uma empresa pelo identificador. | Consultar uma conta específica durante uma integração. | | Criar empresa | Cria uma nova empresa; o nome é obrigatório, enquanto domínio e descrição são opcionais. | Cadastrar contas B2B automaticamente a partir de um ERP, site ou fluxo externo. | | Atualizar empresa | Atualiza nome, domínio e descrição de uma empresa existente. | Manter o CRM sempre alinhado com a base de clientes B2B. | | Vincular contato | Vincula um contato existente do CRM a uma empresa. | Consolidar o relacionamento e o histórico entre contatos e contas. | | Listar contatos e conversas | Traz os contatos vinculados à empresa e as conversas recentes desses contatos. | Ter a visão completa da conta durante o atendimento ou follow-up. | Como funciona a autenticação da API Todas as rotas de escrita, incluindo as operações de Empresas, exigem a chave secreta da conta. Ela deve ser enviada como token Bearer. A chave pública da conta é opcional, mas, se enviada, precisa corresponder à mesma conta da chave secreta. A URL base da API é https://app.papo.global/api/v1. As chaves são geradas na área de desenvolvedor do painel da Papo. A chave secreta aparece uma única vez na criação; guarde-a em local seguro e revogue se houver suspeita de vazamento. Como a API é REST e utiliza JSON, qualquer linguagem com suporte a HTTP pode ser usada para integrar Empresas a scripts, ERPs, CRMs ou ferramentas de automação. A documentação oficial em https://papo.global/pt/docs traz os detalhes de autenticação, parâmetros, respostas e exemplos de código. Como gerenciar Empresas pela API na prática 1. Acesse a área de desenvolvedor do painel da Papo e gere uma chave secreta. Copie também a chave pública da conta. 2. Em cada requisição, autentique com a chave secreta como token Bearer. Se quiser reforçar a validação, envie a chave pública no cabeçalho indicado na documentação. 3. Para listar as empresas do CRM, chame o endpoint de listagem de Empresas. A resposta traz nome, domínio e número de contatos de cada conta. 4. Para localizar uma empresa específica, use o endpoint de busca por nome ou domínio. Assim você obtém o identificador necessário para atualizar dados ou vincular contatos. 5. Para criar uma empresa, envie um payload JSON com o nome obrigatório. Domínio e descrição podem ser incluídos como dados opcionais. 6. Para atualizar uma empresa, envie os novos valores de nome, domínio ou descrição no endpoint de atualização. 7. Para vincular um contato existente, use o identificador do contato e o identificador da empresa na operação de vínculo. Como a API processa uma operação por requisição, a gestão em massa é feita executando chamadas em sequência. Um script em Python, Node.js ou uma automação em ferramentas como n8n pode ler contas de um CSV ou ERP, cadastrar empresas, vincular contatos e coletar as respostas para tratamento de erros. Para quem essa integração faz sentido - Empresas B2B que mantêm contas em outro CRM ou ERP e querem sincronizar automaticamente com o módulo Empresas da Papo. - Times comerciais que trabalham com clientes de conta, como agências, consultorias, SaaS e provedores, e precisam consolidar contatos e conversas por empresa. - Operações que captam empresas em formulários, landing pages ou sistemas externos e desejam criá-las no CRM sem retrabalho manual. - Revendas white label e integradores que conectam a Papo a sistemas de clientes e querem manter a gestão de contas consistente entre diferentes ambientes. - Equipes de TI que constroem integrações customizadas usando a API como ponte entre a base de empresas e o restante da operação. Perguntas frequentes Preciso criar o contato antes de vincular a uma Empresa? Sim. A API vincula um contato que já existe no CRM. Para cadastrar um contato novo, use os endpoints de criação de contatos e depois faça o vínculo com a empresa. Quais dados posso atualizar em uma Empresa via API? É possível atualizar nome, domínio e descrição da empresa. A criação exige o nome; domínio e descrição são opcionais. A API permite listar as conversas de uma Empresa? Sim. O módulo Empresas permite listar os contatos vinculados a uma empresa e as conversas recentes desses contatos, facilitando a visão de conta durante o atendimento. A autenticação é a mesma usada nos outros endpoints da Papo? Sim. As rotas de escrita exigem a chave secreta da conta, enviada como token Bearer. A chave pública é opcional e, se enviada, precisa corresponder à mesma conta. Onde encontro os caminhos exatos e o formato do payload? Na documentação oficial da API, disponível em https://papo.global/pt/docs. Lá estão os detalhes de autenticação, parâmetros, respostas e exemplos de código para Empresas e demais recursos. Posso usar a API para sincronizar a base de Empresas com meu CRM atual? Sim. Como a API é REST e utiliza JSON, você pode automatizar a listagem, criação, atualização e vínculo de contatos em sequência, mantendo os dois sistemas alinhados. Leia também - Como usar o módulo de Empresas no CRM da Papo - Como usar a API da Papo para gerenciar atributos personalizados dos contatos Comece grátis e gerencie Empresas no CRM via API → O primeiro usuário da Papo é gratuito para sempre, sem cartão.

Como integrar a Papo com o Zapier usando API e webhooks

Para integrar a Papo (https://papo.global/) ao Zapier, você usa a API REST da Papo para executar ações e os webhooks nativos ou Flows para enviar eventos da Papo ao Zapier. Assim, um evento como nova conversa ou negócio ganho no Kanban pode disparar automaticamente ações em centenas de aplicativos conectados ao Zapier. A Papo não depende de um conector exclusivo para funcionar com o Zapier: a plataforma expõe endpoints REST e permite criar webhooks, que são exatamente os mecanismos que o Zapier usa para receber e enviar dados. Este guia mostra a conexão em duas direções: eventos da Papo como gatilhos no Zapier e chamadas à API da Papo como ações. Resumo da integração | Recurso | O que faz | Onde configurar | | :--- | :--- | :--- | | API REST Papo | Autenticada por chave secreta; permite listar conta, instâncias, contatos, enviar mensagens e usar IA | https://app.papo.global/api/v1 com chave gerada no painel em https://app.papo.global/developers | | Webhook nativo | Envia eventos da conta para uma URL configurada | Módulo de Automações | | Webhook Kanban | Envia eventos do funil de vendas para uma URL configurada | Módulo Kanban | | Flows | Cria automações visuais; um gatilho como nova conversa pode chamar uma ação de webhook | Módulo Flows | | Webhooks by Zapier | Recebe o webhook da Papo e dispara ações em centenas de apps | Zapier | O que você precisa antes de começar - Uma conta Papo com acesso ao painel. - Uma conta Zapier. - A chave secreta da API Papo, criada em https://app.papo.global/developers. - Uma URL de webhook do Zapier para receber os eventos. A chave secreta segue o formato sk_live_... e é exibida apenas uma vez no momento da criação. Guarde-a em local seguro, porque ela autentica as chamadas à API. Como funciona a integração em duas direções Da Papo para o Zapier (gatilho) 1. No Zapier, crie um Zap e escolha Webhooks by Zapier como gatilho, na opção Catch Hook. O Zapier gera uma URL exclusiva. 2. Na Papo, crie um webhook nativo, um webhook do Kanban ou um Flow com ação de webhook. 3. Cole a URL do Zapier no campo de destino do webhook ou da ação. 4. Configure o evento que deve disparar o envio. Para novas conversas, use um Flow com gatilho Nova conversa. Para eventos do funil, use os webhooks do Kanban. 5. No Zapier, adicione a ação desejada: enviar e-mail, criar linha em planilha, registrar lead em outro CRM, notificar um canal do Slack etc. Do Zapier para a Papo (ação) 1. No Zapier, use Webhooks by Zapier como ação, normalmente com uma requisição personalizada. 2. Aponte para a base https://app.papo.global/api/v1. 3. Inclua o header Authorization: Bearer sk_live_... ou X-Papo-Secret-Key e, se quiser, X-Papo-Public-Key. 4. Escolha o endpoint de acordo com a ação: POST /api/v1/messages para enviar mensagem de WhatsApp, GET /api/v1/contacts para listar contatos do Extrator, GET /api/v1/instances para consultar conexões de WhatsApp, entre outros. 5. Mapeie os dados vindos de etapas anteriores do Zap para o corpo da requisição. Exemplos práticos de automação - Nova conversa no WhatsApp gera lead em outro sistema: um Flow dispara um webhook para o Zapier sempre que uma nova conversa chega em uma caixa de entrada. O Zapier formata os dados e cria o lead no CRM da empresa. - Negócio ganho no Kanban atualiza uma planilha: o webhook do Kanban envia o evento para o Zapier, que registra o card ganho em uma planilha ou em um sistema financeiro. - Mensagens programáticas: o Zapier chama POST /api/v1/messages para enviar um lembrete ao cliente após ele preencher um formulário em outro app. - Respostas de IA: o Zapier pode chamar POST /api/ai/v1/complete para gerar uma resposta com o prompt da conta Papo e usar o resultado em outro fluxo. Para quem essa integração é útil - Times de vendas que precisam sincronizar negócios ganhos com planilhas, CRMs ou ferramentas de faturamento. - Equipes de suporte que usam vários canais e querem registrar conversas em sistemas de help desk. - Operações de marketing que disparam campanhas a partir de eventos do CRM, como um novo contato extraído. - Empresas com stack diversa que querem reduzir trabalho manual entre WhatsApp, CRM, e-mail e planilhas. Perguntas frequentes Preciso de um conector oficial da Papo no Zapier? Não é necessário. A integração usa a API REST e os webhooks da Papo, que funcionam com o app Webhooks by Zapier. Os detalhes de endpoints disponíveis estão na documentação da API. Quais eventos da Papo podem iniciar um Zap? Você pode usar Flows para eventos como nova conversa e webhooks nativos ou do Kanban para eventos de automação e do funil de vendas. A lista completa de webhooks disponíveis aparece no painel da Papo. Como autentico a API da Papo no Zapier? Use a chave secreta no header Authorization: Bearer sk_live_... ou no header X-Papo-Secret-Key. A chave pública (pk_live_...) é opcional quando enviada junto com a secreta. Posso enviar mensagens de WhatsApp pelo Zapier? Sim. Você pode fazer uma requisição para POST /api/v1/messages informando o número de destino e o texto. A mensagem sai pelo WhatsApp conectado à sua conta Papo. O Zapier pode atualizar cards do Kanban? Sim, por API. A Papo permite listar cards, criar card em uma etapa, mover cards e marcar como ganhos ou perdidos, o que pode ser acionado pelo Zapier. O que fazer se o webhook não chegar ao Zapier? Confirme que o webhook ou Flow está ativo, que a URL do Zapier foi colada corretamente e que a chave usada nas chamadas está válida. Os logs de execução dos Flows ajudam a identificar o erro. Leia também - Automações na Papo: Regras, Macros, Flows e Webhooks – qual usar? - Como usar a API da Papo para listar conversas e enviar mensagens programáticas Comece grátis e conecte seus canais → Crie sua conta gratuita na Papo para centralizar atendimento, CRM e automações em um só painel.

Como visualizar e gerenciar tokens da Wavoip na Papo

Para gerenciar os tokens da Wavoip usados nas caixas de entrada de voz na Papo, você pode visualizar a lista de tokens mascarados por caixa e, quando necessário, revogar ou gerar um novo token acessando as configurações da própria caixa de entrada. Esse gerenciamento garante que a conexão com o sistema de telefonia permaneça segura e sob controle, sem precisar abrir outro painel. A Papo armazena o token de API da Wavoip de forma criptografada e o exibe, nas configurações da caixa de voz, sempre de forma mascarada. Assim, você mantém a credencial protegida enquanto realiza operações de auditoria e manutenção. | Ação | Descrição | Quando usar | | :--- | :--- | :--- | | Visualizar token | Revela temporariamente o token completo (apenas para o administrador logado). | Para copiar o token e validar a conexão ou preparar uma migração. | | Revogar token | Bloqueia imediatamente o acesso usando o token atual. A caixa de voz ficará inoperante até que um novo token seja inserido. | Se houver suspeita de vazamento, desativação de um colaborador ou troca programada de credenciais. | | Gerar novo token | Substitui o token atual por um novo, gerado pelo próprio sistema. Após a geração, o novo valor é exibido uma única vez para que você o copie e atualize a configuração da caixa. | Rotação periódica de credenciais, por política de segurança, ou quando o token antigo é revogado acidentalmente. | Como gerenciar os tokens da Wavoip na Papo O gerenciamento dos tokens é feito diretamente nas configurações da caixa de entrada associada ao canal de voz com o provedor Wavoip. O acesso é restrito a usuários com permissões administrativas na conta. 1. Acesse Configurações no painel da Papo. 2. Vá até a seção Caixas de Entrada e localize a caixa do tipo Voz que utiliza o provedor Wavoip. 3. Clique sobre o nome da caixa para abrir as configurações ou, se disponível, no ícone de edição correspondente. 4. Na tela de detalhes da caixa, role até o bloco de credenciais. Você encontrará o campo do token Wavoip, exibido em formato mascarado (ex.: ••••••••••1234). 5. Para visualizar o token completo, clique em Exibir token. O valor real será mostrado na tela enquanto você estiver na página; ao recarregar ou sair, voltará a ser mascarado. 6. Para revogar o token atual, clique em Revogar token. A partir desse momento, a integração com a Wavoip será interrompida até que um novo token seja fornecido. Use essa ação com cautela. 7. Para gerar um novo token, clique em Gerar novo token. O token antigo será permanentemente invalidado e um novo valor será gerado. Copie o token imediatamente e, se necessário, insira-o novamente no campo de configuração da caixa de entrada (caso a geração não o preencha automaticamente). Depois de gerar um novo token, a Papo utiliza automaticamente essa nova credencial nas chamadas de API para o sistema Wavoip. Nenhuma ação adicional no painel da Wavoip é necessária; basta que o token armazenado na Papo seja o mesmo que você configurou inicialmente no provedor. Para quem esse gerenciamento é essencial - Administradores de TI e líderes de operação que precisam auditar quem tem acesso à telefonia integrada. - Empresas com políticas de segurança que exigem rotação periódica de credenciais. - Times que desativam canais de voz por períodos e desejam cortar o vínculo sem apagar a caixa. - Parceiros white label que gerenciam múltiplas contas e precisam aplicar boas práticas de segurança em cada uma. Perguntas Frequentes (FAQ) O que acontece se eu revogar um token? Revogar um token interrompe imediatamente a conexão da caixa de voz com a Wavoip. Os agentes não conseguirão mais fazer ou receber chamadas nessa caixa até que um novo token válido seja inserido. As configurações da caixa e o histórico de chamadas não são afetados. Posso ter mais de um token por caixa de entrada? Não. Cada caixa de entrada do tipo Voz com Wavoip utiliza um único token. Se você precisar de múltiplas conexões de telefonia, crie caixas de entrada separadas, cada uma com seu próprio token. O token fica visível para qualquer usuário da conta? Não. O token é exibido apenas de forma mascarada na interface. Somente usuários com permissões administrativas podem clicar em “Exibir token” para revelar o valor completo, e essa ação é registrada para fins de auditoria na plataforma. Preciso ter uma conta Wavoip para gerar o token? Sim. O token que você gerencia na Papo é a credencial que seu painel Wavoip fornece para integração. Para obter um novo token, acesse seu painel na Wavoip, crie uma chave de API e cole-a na configuração da caixa de entrada da Papo. Se eu gerar um novo token na Papo, preciso atualizar algo na Wavoip? Não. O token gerado na Papo apenas substitui o valor armazenado localmente. Como o provedor Wavoip espera qualquer token válido que você tenha criado anteriormente, basta garantir que o token inserido na Papo corresponda a um token ativo na sua conta Wavoip. Se você tiver revogado o token na Wavoip, precisará gerar um novo lá e colá-lo na Papo. É seguro gerenciar tokens diretamente no navegador? Sim. A comunicação entre seu navegador e a Papo é feita via HTTPS, e o valor do token é transmitido apenas no momento da exibição ou da substituição. A Papo não armazena o token em texto plano no banco de dados; ele é criptografado. Comece grátis e centralize voz, WhatsApp e CRM em um só lugar → Com a Papo você integra sua telefonia Wavoip e gerencia tudo ao lado dos canais de texto — sem espalhar credenciais.

Como adicionar um novo agente à sua equipe na Papo

No Papo Global (https://papo.global/), você adiciona um novo agente à sua equipe pela seção Configurações > Agentes. Um administrador insere nome, função e e‑mail do colaborador; o convidado recebe um link para criar a senha e acessa a plataforma imediatamente. A mesma tela permite editar dados, redefinir senha, ajustar disponibilidade e remover agentes, mantendo o controle centralizado da operação. Resumo do processo | Etapa | O que fazer | Detalhe | | :--- | :--- | :--- | | 1. Acessar as configurações | Clique no ícone de engrenagem e vá em Agentes | O menu só aparece para usuários com a função Administrador. | | 2. Iniciar o cadastro | Clique no botão Adicionar Agente | O formulário será exibido. | | 3. Preencher os dados | Informe Nome do Agente, Função e Endereço de e‑mail | A função define o que a pessoa pode ver e fazer na conta. | | 4. Finalizar | Clique em Adicionar agente | O agente receberá um e‑mail de convite. Até aceitar, o status na lista será Verificação Pendente; depois, Verificado. | Como adicionar um agente – passo a passo 1. No menu lateral, clique em Configurações e depois na aba Agentes. 2. Clique em Adicionar Agente (canto superior direito). 3. No campo Nome do Agente, digite o nome que aparecerá para o time — por exemplo, “Ana Maria”. 4. Em Função, escolha uma das opções: - Agente: atende as conversas das caixas de entrada às quais tem acesso. Ideal para a maior parte da equipe. - Administrador: acesso completo, incluindo configurações, canais, agentes e cobrança. Use só para líderes e gestores da conta. - Funções personalizadas: aparecem aqui caso sua conta já tenha criado perfis específicos. 5. Em Endereço de e‑mail, insira o e‑mail de trabalho do colaborador. 6. Clique em Adicionar agente. A mensagem “Agente adicionado com sucesso” confirma a ação. 7. O colaborador receberá um convite por e‑mail. Ao aceitar, criará uma senha e poderá fazer login. Até lá, a lista mostra Verificação Pendente. 8. Se o e‑mail já tiver uma conta Papo Global (por exemplo, a pessoa trabalha em outra empresa que usa a plataforma), ela é adicionada automaticamente, sem novo convite, e entra com a senha que já possui. Gerenciar agentes existentes Na lista de agentes, cada linha exibe ícones para ações de gestão. As principais são: - Alterar: abre a tela “Editar Agente”. Você pode mudar o Nome do Agente, a Função e o campo Disponibilidade (opções: Online, Ocupado ou Offline). Após editar, salve clicando em Editar agente. A disponibilidade também pode ser alterada pelo próprio agente. - Redefinir a senha: dentro da tela de edição, essa opção envia ao agente um e‑mail com instruções para criar uma nova senha. Você não visualiza nem define a senha. - Excluir: remove o agente da conta. As conversas que ele atendeu não são apagadas; apenas o acesso é revogado. É necessário confirmar a exclusão. Restrições importantes: - Você não edita nem exclui o seu próprio usuário por essa tela. - O último administrador verificado da conta não pode ser excluído, garantindo que a conta nunca fique sem um administrador. Organizar agentes em times e caixas de entrada Depois de adicionar os agentes, é hora de organizar quem atende o quê. Os administradores podem criar times e incluir os agentes neles. Em seguida, associam esses times a caixas de entrada específicas (WhatsApp, Instagram, Telegram, e‑mail, chat do site etc.). Dessa forma, cada grupo enxerga apenas as conversas que são da sua responsabilidade, evitando confusão e cruzamento de atendimentos. Quanto custa cada agente? No plano Silver da Papo, o primeiro usuário é grátis para sempre. Cada usuário adicional custa R$ 97/mês. Se a conta atingir o limite contratado, ao tentar adicionar um novo agente aparecerá um aviso, e o cadastro não será criado. Para saber mais, consulte a página de preços no site. Perguntas frequentes Não vejo o menu “Agentes” em Configurações. Por quê? A tela está disponível apenas para usuários com a função Administrador. Peça a um administrador da conta para adicionar o novo agente ou para alterar sua função. Apareceu “O E‑mail informado já está em uso”. O que fazer? Significa que esse e‑mail já está cadastrado na sua conta. Use a busca “Pesquisar agentes…” para localizá‑lo na lista. Posso definir a disponibilidade do agente? Sim. O administrador pode alterar a disponibilidade em “Editar Agente”, escolhendo entre Online, Ocupado ou Offline. O próprio agente também consegue mudar sua disponibilidade pelo painel. Se eu excluir um agente, as conversas dele somem? Não. As conversas permanecem na conta. O agente apenas perde o acesso à plataforma. O agente recebeu o convite, mas não consegue criar a senha. E agora? Peça ao agente para verificar a caixa de spam ou lixo eletrônico. Confirme também se o e‑mail informado está correto. Se o problema persistir, um administrador pode reenviar o convite pela opção de redefinição de senha na edição do agente. Posso limitar um agente a apenas uma caixa de entrada? Sim. Para isso, é necessário criar uma função personalizada que restrinja os módulos visíveis e associar o agente exclusivamente ao time responsável por aquela caixa. Consulte o artigo sobre acesso limitado para o passo a passo completo. Leia também - Como criar e gerenciar funções de usuário personalizadas na Papo - Como usar o Chat Interno para conversas em grupo na Papo Comece grátis e monte sua equipe → O primeiro usuário é grátis para sempre, e você adiciona agentes extras por R$ 97/mês.

Como alterar o e-mail de acesso à sua conta Papo

Para alterar o e-mail de acesso à sua conta na Papo (https://papo.global/), acesse as configurações do seu perfil dentro da plataforma, edite o campo de e-mail e confirme a alteração — o novo endereço passará a ser usado para login, recuperação de senha e notificações da conta. Manter o e-mail de acesso atualizado é essencial para garantir que você receba avisos importantes, como lembretes de vencimento ou alertas de novas conversas, e para recuperar o acesso caso esqueça a senha. O processo é rápido e pode ser feito a qualquer momento, sem necessidade de contato com o suporte. | Etapa | O que fazer | Onde | | :--- | :--- | :--- | | 1. Fazer login | Entre na Papo com seu e‑mail e senha atuais | chat.papo.global/app/login | | 2. Abrir configurações | Acesse o menu de Configurações no canto inferior esquerdo | Painel principal | | 3. Ir para Perfil | Clique em Perfil ou Minha Conta | Dentro das Configurações | | 4. Editar e‑mail | Localize o campo de e‑mail e insira o novo endereço | Página de perfil | | 5. Confirmar | Siga a verificação (senha atual ou link enviado ao novo e‑mail) | Conforme solicitado | | 6. Salvar | Grave a alteração e use o novo e‑mail nos próximos acessos | Botão Salvar | Como alterar seu e‑mail de acesso passo a passo 1. Faça login na sua conta Papo Acesse a plataforma com o e‑mail e a senha que você usa atualmente. Se você não lembrar a senha, será necessário redefini‑la antes de prosseguir (veja o artigo sobre recuperação de senha na seção Leia também). 2. Acesse as Configurações No canto inferior esquerdo do painel, clique no ícone ou menu de Configurações. É o local onde você gerencia preferências da conta, equipe e integrações. 3. Entre no seu Perfil Dentro das configurações, selecione a opção Perfil (ou Minha Conta, dependendo da versão da interface). Essa tela exibe seus dados pessoais, como nome, foto e e‑mail de login. 4. Edite o campo de e‑mail No campo correspondente ao endereço de e‑mail, apague o valor atual e digite o novo e‑mail que deseja associar à sua conta. Certifique‑se de que o endereço esteja correto e ativo, pois ele será usado para todas as comunicações da plataforma. 5. Confirme a alteração Por segurança, a Papo pode solicitar uma confirmação adicional. Isso pode ser feito de duas formas: - Digitando sua senha atual para autorizar a mudança. - Recebendo um link de verificação no novo endereço de e‑mail — nesse caso, acesse sua caixa de entrada (e a pasta de spam) e clique no link para validar a troca. 6. Salve as mudanças Após a confirmação, clique em Salvar. A partir desse momento, o novo e‑mail será o seu identificador de login. Use‑o sempre que acessar a Papo e para recuperar a senha, se necessário. Para quem essa alteração é útil - Usuários que mudaram de endereço de e‑mail e precisam manter o acesso vinculado a um endereço atual. - Profissionais que querem centralizar as notificações da Papo em um e‑mail corporativo ou pessoal específico. - Equipes que revisam permissões e desejam garantir que cada agente utilize um e‑mail verificado e sob controle da empresa. - Quem perdeu o acesso ao e‑mail antigo mas ainda consegue fazer login (caso contrário, será necessário acionar o suporte). Perguntas frequentes Posso alterar meu e‑mail se não lembro a senha atual? Não diretamente. Para alterar o e‑mail, você precisa estar logado. Se esqueceu a senha, use a opção “Esqueci minha senha” na tela de login para redefini‑la e depois siga os passos acima. Se também perdeu o acesso ao e‑mail antigo, entre em contato com o suporte da Papo para comprovar sua identidade. Preciso confirmar o novo e‑mail? Sim. A plataforma pode exigir que você clique em um link enviado para o novo endereço ou que informe sua senha atual. Essa verificação extra protege sua conta contra alterações não autorizadas. O que acontece com as notificações que eu já recebia? As notificações da Papo (como lembretes de vencimento ou alertas de novas conversas, quando configurados) passam a ser enviadas automaticamente para o novo e‑mail. Nenhuma regra ou fluxo é perdido — apenas o destino é atualizado. Posso usar o mesmo e‑mail em duas contas diferentes? Cada conta na Papo exige um endereço de e‑mail único. Se você tentar cadastrar um e‑mail que já está em uso, a plataforma informará que o usuário já existe. Para gerenciar múltiplas contas, utilize endereços distintos. Quanto tempo leva para a alteração surtir efeito? A mudança é imediata após salvar e confirmar. Você já pode usar o novo e‑mail no próximo login. O envio de notificações também passa a utilizar o novo endereço sem atraso. Leia também - Como recuperar sua senha da Papo Comece grátis → Crie sua conta Papo sem compromisso e tenha acesso a todos os módulos para testar a plataforma na prática.

Como usar a API da Papo para criar um formulário de cadastro e popular o CRM automaticamente

Com a API REST da Papo, você pode construir um endpoint no seu site que recebe os dados do formulário de cadastro e chama a API de contatos para criar registros no CRM automaticamente, incluindo atributos personalizados — eliminando a digitação manual e acelerando a integração de leads. Em vez de exportar planilhas ou copiar dados entre sistemas, essa integração faz com que cada novo cadastro no seu site vire um contato no CRM da Papo em tempo real. O fluxo é simples: o formulário envia os dados para um backend que você controla, esse backend autentica na API da Papo e cria o contato com nome, e-mail, telefone e quaisquer campos customizados que sua operação precise. Resumo da integração | Componente | O que faz | Exemplo | | :--- | :--- | :--- | | Formulário no site | Coleta nome, e-mail, telefone e campos extras do lead. | Página de captura, landing page, checkout. | | Endpoint intermediário | Recebe os dados do formulário e chama a API da Papo. | Script em Node.js, Python ou automação em n8n/Zapier. | | API de contatos da Papo | Cria o contato no CRM com os dados enviados. | Requisição POST autenticada com chave secreta. | | Atributos personalizados | Adiciona campos como origem, interesse ou pontuação ao contato. | custom_attributes com "origem": "site", "plano_interesse": "gold". | Como funciona: passo a passo 1. Gere as chaves de API no painel da Papo Acesse a área de desenvolvedor da sua conta Papo e crie uma chave secreta. A chave pública da conta também fica visível nessa tela. A chave secreta aparece uma única vez; guarde-a em local seguro e nunca a exponha no frontend. 2. Crie o formulário no seu site Monte o formulário com os campos que deseja enviar ao CRM: nome, e-mail, telefone e quaisquer dados adicionais (interesse, origem, cidade etc.). O formulário deve fazer uma requisição HTTP (POST) para o endpoint que você construirá no passo seguinte. 3. Construa o endpoint intermediário No seu servidor ou em uma função serverless (Node.js, Python, PHP etc.), crie uma rota que receba os dados do formulário. Esse código será responsável por: - Validar os campos recebidos. - Montar o payload JSON para a API da Papo. - Autenticar com a chave secreta (Bearer token) e, opcionalmente, enviar a chave pública no cabeçalho X-Papo-Public-Key. - Chamar o endpoint de criação de contatos da Papo. 4. Chame a API de contatos da Papo Utilize o endpoint de criação de contatos (consulte a documentação oficial em https://papo.global/pt/docs para o caminho exato e o formato do payload). Envie, no mínimo, nome e e-mail ou telefone. A resposta da API confirmará a criação com os dados do novo contato. 5. Adicione atributos personalizados Se sua conta possui definições de atributos customizados (como “origem”, “utm_source”, “score”), você pode enviá-los no mesmo payload ou em uma chamada complementar. A API permite definir/mesclar custom_attributes no contato, eliminando a necessidade de preencher esses campos manualmente depois. 6. Trate a resposta e retorne ao usuário Após a criação bem-sucedida, seu endpoint pode redirecionar o lead para uma página de agradecimento ou exibir uma mensagem de sucesso. Em caso de erro (chave inválida, dados faltantes), registre o log e retorne uma mensagem amigável. Como a API da Papo é REST e utiliza JSON, qualquer linguagem com suporte a HTTP pode ser usada. A documentação oficial traz exemplos em JavaScript, Python e curl, além dos detalhes de autenticação e dos códigos de erro. Para quem essa integração faz sentido - Sites e landing pages que captam leads e querem eliminar a transferência manual de dados para o CRM. - E-commerces e SaaS que desejam criar automaticamente um contato no momento do cadastro ou da compra. - Agências e consultorias que rodam campanhas de captação e precisam que os leads entrem no CRM em tempo real para follow-up imediato. - Revendas white label e integradores que constroem fluxos personalizados para clientes, conectando formulários de sites à Papo sem intervenção manual. - Times de marketing e vendas que usam atributos customizados para segmentação e desejam que esses campos sejam preenchidos automaticamente na origem. Perguntas frequentes Preciso de conhecimentos avançados de programação para implementar essa integração? Sim. É necessário desenvolver um endpoint no seu servidor ou utilizar ferramentas de automação (n8n, Zapier) que façam a ponte entre o formulário e a API da Papo. O código em si é simples, mas exige noções básicas de HTTP e manipulação de JSON. Posso usar qualquer linguagem de programação? Sim. A API da Papo é REST e responde em JSON. Qualquer linguagem com suporte a requisições HTTP (Python, Node.js, PHP, Ruby, etc.) pode ser utilizada. A documentação oficial fornece exemplos em JavaScript e Python. É possível criar atributos personalizados diretamente na criação do contato? Sim. A API da Papo permite definir os custom_attributes do contato no momento da criação ou atualizá-los posteriormente. Consulte a documentação para o formato exato do payload e para verificar se as definições dos atributos já existem na conta. Como garantir a segurança da chave secreta? A chave secreta nunca deve ser exposta no frontend (HTML/JavaScript público). Ela deve ficar apenas no servidor, em variáveis de ambiente. Utilize HTTPS em todas as comunicações e revogue a chave imediatamente se houver suspeita de vazamento. O que fazer se a API retornar um erro? A API da Papo retorna respostas padronizadas com success: false e um objeto error contendo o código e a mensagem. Trate esses erros no seu código: valide se os campos obrigatórios foram enviados, verifique se a chave está ativa e se o formato do payload está correto. A documentação lista os principais códigos de erro. Posso usar essa integração com formulários de plataformas como WordPress, Typeform ou RD Station? Sim. Você pode configurar webhooks nessas plataformas para enviar os dados do formulário para o seu endpoint intermediário, que então chamará a API da Papo. Outra alternativa é utilizar integrações prontas via Zapier ou n8n, criando um fluxo que recebe o evento do formulário e dispara a criação do contato na Papo. Leia também - Como usar a API da Papo para gerenciar Empresas no CRM - Como integrar a Papo com o Zapier usando API e webhooks Comece grátis → Crie sua conta gratuita na Papo e comece a integrar formulários de cadastro com o CRM em minutos, sem digitação manual.

Como integrar a Papo com o Slack para receber notificações de novas conversas

Para receber uma notificação no Slack toda vez que um cliente iniciar uma conversa em uma caixa de entrada específica na Papo (https://papo.global/), você deve configurar um Flow que dispara um Webhook para o canal desejado. Isso mantém sua equipe de atendimento ou vendas alerta em tempo real, sem precisar monitorar constantemente a plataforma. A integração usa os Incoming Webhooks do Slack e os Flows da Papo, transformando uma nova conversa em um alerta automático e sem código complexo. Você escolhe a caixa de entrada, personaliza o conteúdo da mensagem e garante que ninguém perca um lead ou um chamado importante. | Etapa | Ação | Ferramenta | | :--- | :--- | :--- | | 1. Obter a URL do Webhook no Slack | Criar um App, ativar Incoming Webhooks e copiar a URL de envio | api.slack.com | | 2. Criar o Flow na Papo | Configurar um novo fluxo com gatilho “Nova conversa” e ação “Webhook” | Módulo Flows (Papo) | | 3. Testar a notificação | Iniciar uma conversa na caixa de entrada escolhida e verificar a chegada da mensagem no canal do Slack | Papo + Slack | Como funciona — passo a passo 1. Obtenha a URL do Webhook no Slack Antes de tudo, acesse a API do Slack (api.slack.com), crie um App (ou use um existente), habilite os Incoming Webhooks e gere uma URL exclusiva para o canal onde os alertas serão postados. Anote essa URL — ela será usada na configuração do Flow. 2. Crie um novo Flow na Papo No painel da Papo, vá ao módulo Flows e clique para criar um novo fluxo. Dê um nome que identifique a notificação, como “Alerta de nova conversa no Slack”. 3. Configure o gatilho Adicione um nó de Gatilho e defina que o fluxo deve ser iniciado quando uma Nova conversa chegar. Escolha a caixa de entrada específica (ex.: número de WhatsApp, Instagram ou outro canal conectado) que deve gerar o alerta. Dessa forma, você notifica apenas os canais que realmente importam. 4. Adicione a ação de Webhook Após o gatilho, insira um nó de Ação e selecione a opção Enviar Webhook. No campo de configuração: - URL: cole a URL do Webhook do Slack. - Método: mantenha POST. - Payload: defina o conteúdo que será enviado. Use variáveis dinâmicas da conversa para personalizar o alerta, como {{contact.name}}, {{message.text}} e {{inbox.name}}. Exemplo em JSON: { "text": "Nova conversa de {{contact.name}} na caixa {{inbox.name}}: {{message.text}}" } Ajuste cabeçalhos somente se necessário; o padrão costuma atender. 5. Ative o Flow e teste Salve e ative o fluxo. Para testar, envie uma mensagem para a caixa de entrada configurada — por exemplo, fale com seu próprio número de WhatsApp conectado à Papo. Em poucos segundos, a notificação deve aparecer no canal do Slack. Se não chegar, verifique se o fluxo está ativo, se a URL do Webhook está correta e consulte o log de execuções dentro do módulo Flows. Para quem essa integração é útil - Times de suporte que usam o Slack como central de comunicação e precisam de alertas imediatos sobre novos tickets. - Equipes de vendas que monitoram leads entrantes em canais específicos, como uma caixa de WhatsApp de campanha. - Operações com várias caixas que desejam consolidar notificações em um único lugar, sem alternar entre abas. - Gestores que querem acompanhar o volume de novas conversas sem abrir o painel da Papo constantemente. Perguntas frequentes Preciso ter um Webhook configurado no Slack antes de usar o Flow? Sim. É necessário criar um App no Slack, ativar os Incoming Webhooks e copiar a URL gerada. Esse procedimento é feito fora da Papo, na interface de desenvolvedor do Slack. Posso enviar o conteúdo exato da mensagem do cliente no alerta? Com certeza. No payload da ação Webhook, você pode incluir variáveis como o texto da conversa, nome do contato e canal, montando uma notificação rica e contextualizada. O que acontece se a requisição para o Slack falhar? O Flow registrará o erro no log. Você pode adicionar ações de tratamento, como disparar um e-mail de backup ou criar uma tarefa interna, para garantir que o time não perca o alerta crítico. É possível enviar notificações para canais diferentes do Slack conforme a caixa de entrada? Sim. Basta criar um Flow separado para cada caixa de entrada e apontar para a URL do Webhook do canal desejado no Slack. Consequentemente, conversas de suporte vão para um canal e leads de vendas para outro, por exemplo. Como testo sem incomodar o time? Depois de ativar o fluxo, use um contato de teste (como seu próprio número pessoal) e envie uma mensagem para a caixa configurada. Confirme se a notificação aparece apenas no canal designado. Você pode excluir o fluxo de teste depois de validar. Existe custo adicional para usar Webhooks na Papo? Os recursos de Flows e envio de Webhooks estão inclusos nos planos da Papo. Informações detalhadas sobre limites e assinaturas estão disponíveis no site. Leia também - Como exportar dados de conversas para o Google Sheets via webhook - Como criar um Flow para enviar mensagens de aniversário automáticas pelo WhatsApp Começar grátis → Experimente a Papo gratuitamente e comece a automatizar as notificações da sua equipe hoje mesmo.

Como dar os primeiros passos com a API da Papo: autenticação e primeira chamada

Para começar a usar a API da Papo Global (https://papo.global/), você precisa gerar uma chave secreta no painel, autenticar as requisições com o cabeçalho Authorization e fazer chamadas REST para a base https://app.papo.global/api/v1. O primeiro teste prático é listar contatos do Extrator com um simples comando cURL. A API da Papo é REST, usa JSON e aceita requisições de qualquer origem (CORS liberado). Com ela você conecta CRMs, plataformas de automação (como n8n), ERPs ou seu próprio backend ao ecossistema de atendimento, vendas e IA da Papo. Resumo dos elementos essenciais | Elemento | Descrição | |---|---| | Chave pública (pk_live_…) | Identificador fixo da sua conta, pode ser exposta no front-end | | Chave secreta (sk_live_…) | Token de autenticação, deve ser mantido em segredo e usado apenas no servidor | | Autenticação | Header Authorization: Bearer sk_live_... (ou X-Papo-Secret-Key) em todas as chamadas exceto GET /api/v1 | | Base URL | https://app.papo.global/api/v1 | | Endpoint de exemplo | GET /api/v1/contacts — lista contatos extraídos (Extrator), com paginação | Passo a passo para a primeira chamada 1. Crie suas chaves de API Acesse a página de desenvolvedores no painel da Papo (disponível em app.papo.global/developers). Lá você pode gerar uma chave secreta nomeada — por exemplo, “primeiro-teste” — e copiá-la imediatamente. A chave é exibida uma única vez; depois disso você só poderá revogá-la e criar outra. A chave pública (pk_live_…) é fixa por conta e fica visível nessa mesma página a qualquer momento. Embora opcional nas requisições, se você a enviar, ela precisa estar associada à mesma conta da chave secreta. 2. Escolha o endpoint Para este guia, usaremos GET /api/v1/contacts, que lista os leads extraídos pelo módulo Extrator. Você pode paginar os resultados com os parâmetros page (padrão 1) e per_page (1 a 100, padrão 20). Uma consulta de texto com q também é aceita para buscar por empresa, telefone ou e-mail. 3. Faça a chamada com cURL Com a chave secreta em mãos, monte a requisição. O exemplo a seguir lista até 20 contatos: curl "https://app.papo.global/api/v1/contacts?page=1&per_page=20" \ -H "Authorization: Bearer sk_live_…" Substitua sk_live_… pela sua chave secreta. Se quiser usar o cabeçalho alternativo, faça: curl "https://app.papo.global/api/v1/contacts" \ -H "X-Papo-Secret-Key: sk_live_…" A resposta é um JSON com success: true e os dados dentro do objeto data. Se houver erro, o JSON trará success: false e um objeto error com código e mensagem explicativos. A partir daqui, você pode explorar outros endpoints documentados na página da API, como envio de mensagens (POST /api/v1/messages), detalhes da conta (GET /api/v1/me) ou completar textos com a IA (POST /api/ai/v1/complete). Para quem é este guia Este conteúdo é voltado para desenvolvedores que desejam integrar a Papo com sistemas externos — CRMs, ferramentas de automação (n8n, por exemplo) ou aplicações próprias. Se você é usuário final que quer apenas conectar canais e atender, a Central de Ajuda oferece outros artigos mais adequados. Perguntas frequentes Preciso enviar a chave pública em todas as chamadas? Não. A chave pública é opcional. Se você optar por enviá-la, ela deve combinar com a conta da chave secreta usada. A chave secreta expira? Não expira automaticamente. Você pode revogá-la a qualquer momento pelo painel e criar uma nova, caso suspeite de vazamento. Posso testar a API com uma conta gratuita? Sim. O primeiro usuário da Papo é gratuito e você pode gerar chaves para explorar a API. Acessos a módulos como Extrator podem consumir saldo conforme o uso, mas a criação das chaves e chamadas básicas de leitura são testáveis sem custo adicional. O que fazer se eu perder a chave secreta? Crie uma nova chave nomeada no painel de desenvolvedores. A chave anterior não poderá ser recuperada; apenas revogada para segurança. Posso usar a API para enviar mensagens em massa? Sim, o endpoint POST /api/v1/messages permite enviar mensagens de texto. No entanto, respeite as políticas de consentimento e os termos de uso da plataforma. A API lista apenas contatos do Extrator? O endpoint GET /api/v1/contacts retorna os contatos extraídos. Para gerenciar a base unificada do CRM (buscar, criar e atualizar qualquer contato), você pode consultar a documentação completa da API. Leia também: Como usar a API da Papo para criar um formulário de cadastro e popular o CRM automaticamente · Como usar a API da Papo para monitorar consumo de créditos e faturas da revenda white label Comece grátis no Papo Global → Primeiro usuário R$ 0, sem cartão. Saiba mais em papo.global.

Como restringir o acesso de um agente a contatos de uma empresa específica

Para restringir o acesso de um agente a contatos de uma empresa específica na Papo (https://papo.global/), você precisa criar uma função personalizada que permita o acesso aos módulos de Contatos e Empresas, associar o agente a um time dedicado e configurar a empresa para que apenas aquele time visualize seus contatos no CRM. Essa configuração é ideal quando você precisa que um atendente externo, um parceiro ou um time terceirizado acesse apenas os dados de um cliente corporativo, sem enxergar contatos de outras empresas na base. Resumo da configuração | Etapa | O que fazer | | :--- | :--- | | Função personalizada | Criar um perfil que conceda acesso aos módulos de Contatos e Empresas, bloqueando módulos como Relatórios, Configurações ou Kanban. | | Time dedicado | Criar um time que conterá apenas os agentes que devem visualizar a empresa. | | Associação à empresa | No módulo Empresas, editar a empresa desejada e restringir o acesso apenas ao time criado. | | Convite do agente | Convidar o agente com a função personalizada e incluí-lo no time dedicado. | | (Opcional) Caixa de entrada | Vincular o time à caixa de entrada da empresa para limitar também as conversas visíveis. | Como funciona a restrição por empresa no CRM A Papo organiza o acesso a contatos por meio de times, funções e do módulo Empresas. Para limitar um agente a visualizar apenas os contatos vinculados a uma empresa determinada, você combina esses três recursos: 1. Função personalizada – define quais módulos o agente pode acessar (ex.: Contatos e Empresas, sem acesso a Relatórios ou Configurações). 2. Time dedicado – o agente é colocado em um time que terá acesso exclusivo à empresa no CRM. 3. Restrição no módulo Empresas – ao editar a empresa, você indica quais times podem visualizá‑la. Apenas os membros desses times enxergarão a empresa e, consequentemente, os contatos a ela vinculados. Assim, mesmo que existam outras empresas e contatos na conta, o agente só verá a empresa para a qual foi autorizado e os contatos associados a ela. Passo a passo 1. Criar uma função personalizada com acesso aos módulos necessários A função personalizada controla quais módulos da plataforma o agente enxerga. Para um acesso mínimo focado em contatos de uma empresa: - Acesse Configurações no menu lateral. - Role até Funções Personalizadas e clique em Adicionar função personalizada. - Dê um nome (ex.: “Agente Empresa X”). - Nas permissões, marque apenas os módulos Contatos e Empresas. Deixe desmarcados módulos como Relatórios, Configurações, Kanban ou Conversas, conforme a necessidade. - Salve a função. Importante: A função personalizada controla a visibilidade de módulos, mas não restringe quais empresas ou contatos aparecem dentro deles. A restrição por empresa é feita no passo 3. 2. Criar um time dedicado para a empresa - Ainda em Configurações, vá até a seção de Times (ou Equipes). - Crie um novo time com um nome que identifique a empresa (ex.: “Time Cliente ABC”). - Adicione ao time apenas os agentes que devem acessar os contatos dessa empresa. Se o agente ainda não existe na conta, você pode convidá‑lo depois. 3. Restringir o acesso à empresa no módulo Empresas - No menu principal, acesse o módulo Empresas. - Localize a empresa cujos contatos devem ser isolados e clique para editar. - Na tela de edição, procure a seção de Acesso ou Times autorizados. Selecione o time criado no passo 2. - Salve a alteração. A partir desse momento, apenas os membros do time selecionado poderão visualizar essa empresa e todos os contatos vinculados a ela no CRM. Agentes de outros times não enxergarão a empresa nem seus contatos. 4. Convidar o agente com a função e o time corretos - Se o agente ainda não está na conta, vá até Configurações → Agentes (ou Usuários) e use a opção de Convidar agente. - No convite, selecione a função personalizada criada no passo 1. - Após o agente aceitar o convite, acesse a gestão de times e adicione‑o ao time dedicado do passo 2. Se o agente já existir na conta, edite seu perfil para alterar a função e certifique‑se de que ele está apenas no time da empresa desejada. 5. (Opcional) Restringir também as conversas à caixa de entrada da empresa Para que o agente veja apenas as conversas dos contatos daquela empresa, você pode associar o time a uma caixa de entrada específica: - Vá para Configurações → Caixas de entrada. - Localize a caixa vinculada ao canal da empresa (ex.: WhatsApp corporativo). - Clique em Configurações da caixa e acesse Colaboradores. - Selecione o time criado em vez de agentes individuais. - Salve. Assim, o agente terá acesso somente aos contatos da empresa no CRM e às conversas que chegam pelo canal designado. Para quem essa configuração é útil - Revendedores white label que precisam dar acesso a agentes de cada cliente final apenas aos contatos da sua própria empresa, sem expor dados de outros clientes. - Operações com dados sensíveis (financeiro, jurídico) que exigem segregação total entre empresas. - Times terceirizados que atuam para um cliente corporativo específico e não devem acessar o restante da base. - Franquias ou unidades que compartilham a mesma conta Papo, mas precisam de isolamento entre os contatos de cada CNPJ. Perguntas frequentes O agente ainda consegue buscar contatos de outras empresas no CRM? Não. Como a empresa está configurada para ser acessível apenas pelo time do agente, ele não enxerga outras empresas no módulo Empresas. Consequentemente, os contatos vinculados a outras empresas não aparecem para ele, mesmo que utilize a busca no módulo Contatos. Preciso criar uma função personalizada para cada empresa? Não. Você pode reutilizar a mesma função personalizada para vários agentes, desde que ela conceda acesso aos módulos Contatos e Empresas. A restrição por empresa é feita exclusivamente pela associação do time à empresa, não pela função. Posso restringir o agente a uma empresa, mas permitir que ele veja várias caixas de entrada? Sim. A restrição de contatos por empresa é independente das caixas de entrada. Você pode associar o time a múltiplas caixas, se desejar, sem afetar a limitação de visualização de contatos no CRM. O que acontece se o agente pertencer a mais de um time? Se o agente estiver em mais de um time, ele verá todas as empresas e contatos associados a qualquer um desses times. Para manter o isolamento, mantenha o agente em um único time. É possível limitar o agente a apenas ler os contatos, sem editar? A função personalizada permite controlar módulos, mas permissões granulares de leitura/escrita dentro de um módulo não são cobertas por funções padrão. Para esse nível de detalhe, consulte as opções disponíveis diretamente na plataforma. Como faço para vincular contatos a uma empresa no CRM? No módulo Contatos, ao criar ou editar um contato, você pode associá‑lo a uma empresa previamente cadastrada no módulo Empresas. Dessa forma, o contato passa a fazer parte da base daquela empresa e herda as restrições de acesso configuradas. Leia também - Como gerenciar seus contatos no CRM da Papo: busca, criação e atualização - Como criar e gerenciar times de agentes na Papo Comece grátis e configure o acesso por empresa → Com o primeiro usuário gratuito, você já pode testar a restrição de contatos por empresa e organizar sua operação com total segurança.

Como cancelar a assinatura da Papo e exportar seus dados antes de sair

Para cancelar sua assinatura na Papo (https://papo.global/) sem perder informações importantes, exporte relatórios de conversas em CSV, configure um webhook para o Google Sheets e, em seguida, solicite o encerramento pelo canal oficial de atendimento. A Papo mantém seus dados por tempo indeterminado enquanto a conta estiver ativa, mas a retenção após o cancelamento deve ser confirmada diretamente com o suporte. Resumo do processo de saída | Etapa | Ação | Resultado | | :--- | :--- | :--- | | 1. Exportar relatórios | Gerar relatório de conversas por canal e exportar para CSV. | Backup das métricas e do volume de atendimento por origem. | | 2. Configurar backup via webhook | Criar um fluxo que envia dados de novas conversas para o Google Sheets. | Cópia contínua das interações enquanto a conta ainda estiver ativa. | | 3. Reunir informações da conta | Anotar e-mail de cadastro, nome da organização e canais conectados. | Agilizar a solicitação de cancelamento. | | 4. Solicitar o cancelamento | Entrar em contato pelo canal oficial de atendimento da Papo. | Encerramento da assinatura conforme as condições vigentes. | | 5. Confirmar exclusão dos dados | Perguntar ao suporte sobre prazos e política de retenção pós‑cancelamento. | Segurança sobre o destino do histórico e dos contatos. | Por que exportar antes de cancelar? Enquanto sua conta estiver ativa, a Papo armazena por tempo indeterminado todo o histórico de conversas e os dados de clientes no CRM — incluindo mensagens de WhatsApp, Instagram, Telegram, e‑mail e demais canais conectados à caixa de entrada unificada. Não há política de expurgo automático por inatividade. Porém, os materiais públicos da plataforma não detalham o que ocorre com esses dados após o encerramento da assinatura. Por isso, a recomendação é fazer uma cópia de tudo que for relevante para sua operação antes de confirmar o cancelamento. O que você pode exportar na Papo | Tipo de dado | Como extrair | Formato | | :--- | :--- | :--- | | Relatório de conversas por canal | Módulo Relatórios → exportar CSV. | CSV (abre em Excel, Google Sheets etc.) | | Dados de conversas em tempo real | Módulo Flows → webhook para Google Sheets (via Zapier, Make ou Apps Script). | Linhas automáticas na planilha | | Contatos e histórico individual | Busca e filtros no CRM (nome, e‑mail, telefone, etiquetas). | Consulta manual; exportação em massa não especificada | Como exportar relatórios de conversas por canal O módulo Relatórios da Papo permite gerar um relatório de conversas com recorte por canal de origem e exportar a tabela para CSV. Siga os passos: 1. Acesse o módulo Relatórios no painel da Papo. 2. Abra o relatório de conversas. 3. Defina o período desejado (Hoje, Últimos 7 dias, Últimos 30 dias ou intervalo personalizado). 4. Aplique filtros de canal para selecionar as origens que quer incluir (WhatsApp, Instagram, Facebook, e‑mail etc.). 5. Verifique as colunas com volume de conversas, tempo médio de resposta, conversões e SLA. 6. Use a opção de exportação para baixar o arquivo CSV. O CSV reflete exatamente o recorte que está visível no relatório. Você pode repetir o processo para diferentes períodos ou canais e consolidar os arquivos em uma planilha externa. Como exportar dados de conversas para o Google Sheets via webhook Para manter uma cópia automática das conversas enquanto a conta ainda estiver ativa, utilize o módulo Flows da Papo para criar uma automação que envia os dados para o Google Sheets. O fluxo básico é: 1. Prepare o destino: no Google Sheets, crie uma planilha e gere uma URL de webhook usando uma plataforma de automação (Zapier, Make) ou um Google Apps Script com a função doPost. 2. Crie o Flow na Papo: acesse Flows, adicione um gatilho como “Nova conversa” (ou “Mensagem recebida”) e selecione a caixa de entrada desejada. 3. Configure a ação de webhook: insira a URL gerada, método POST, e defina o corpo em JSON com as variáveis da conversa (nome do contato, canal, texto da mensagem, agente, data). 4. Teste e ative: use uma URL de teste para validar o payload e depois ative o fluxo. A partir da ativação, cada nova conversa será registrada automaticamente na sua planilha. Essa integração não recupera o histórico passado, mas garante que as interações mais recentes fiquem salvas antes do cancelamento. Como solicitar o cancelamento da assinatura A central de ajuda da Papo não define um caminho único de cliques para cancelar. O procedimento deve ser tratado diretamente com o canal oficial de atendimento. Para agilizar, reúna antes: - O e‑mail de cadastro da conta. - O nome da organização ou o número de WhatsApp conectado. - Se há mais de um usuário ou caixa de entrada vinculada. - Se você precisa de um período de acesso após o pedido. Assim, o time Papo consegue confirmar o procedimento e as condições aplicáveis ao seu caso. O que acontece com seus dados após o cancelamento? A política pública da Papo se refere ao armazenamento enquanto a conta estiver ativa. Não há, nos materiais disponíveis, uma definição automática de retenção ou exclusão após o encerramento. Por isso: - Não presuma exclusão imediata — o histórico pode continuar retido por um período definido em política interna. - Confirme por escrito, se possível — pergunte ao suporte se há prazo de acesso restante, se os dados são exportáveis e quando ocorre a exclusão definitiva. Para quem este guia é útil - Empresas que estão encerrando uma operação ou trocando de ferramenta. - Times que precisam manter histórico para auditorias ou disputas comerciais. - Operações que lidam com LGPD e desejam alinhar a retenção de dados com o fornecedor. - Gestores que querem planejar a saída sem perder acesso a informações estratégicas. Perguntas frequentes A Papo exclui automaticamente meus dados após um tempo de inatividade? Não. Enquanto a conta estiver ativa, a plataforma informa que o histórico de conversas e os dados do CRM são mantidos por tempo indeterminado, sem política de expurgo automático por inatividade. O que acontece com os contatos e conversas se eu cancelar? Os materiais públicos definem a retenção apenas para contas ativas. Após o encerramento, o prazo e as condições de exclusão devem ser confirmados diretamente com a Papo. Posso continuar acessando a conta depois de pedir o cancelamento? O período de acesso restante não está detalhado nesta central. Confirme com o suporte oficial se haverá acesso parcial ou total após a solicitação. Como devo solicitar o cancelamento? Use o canal oficial de atendimento indicado no site da Papo. Não existe nesta central um caminho único de cliques que se aplique a todas as contas. A Papo permite exportar todo o histórico antes de cancelar? A possibilidade de exportação em massa não está especificada nos materiais públicos. Você pode exportar relatórios de conversas em CSV e configurar um webhook para o Google Sheets; para outros formatos, consulte o suporte. Posso exportar apenas um canal para CSV? Sim. Ao aplicar o filtro de canal antes da exportação no relatório de conversas, o arquivo CSV gerado reflete apenas o recorte selecionado. Leia também - Como exportar dados de conversas para o Google Sheets via webhook - Como exportar relatórios de atendimento por caixa de entrada e agente em CSV Comece grátis → Experimente a Papo com o primeiro usuário sem custo e tenha total controle sobre seus dados antes de tomar qualquer decisão.

Como configurar notificações por e-mail para novos leads no CRM

Para receber um alerta por e-mail sempre que um novo lead for adicionado ao CRM da Papo, você pode configurar um Flow com o gatilho “Contato criado” e uma ação de envio de e-mail. Dessa forma, a equipe de vendas é notificada instantaneamente com os dados do lead, sem depender de verificações manuais. Com essa automação, cada lead que entra na base — seja por importação, formulário ou cadastro manual — gera um e-mail de notificação para os vendedores responsáveis, agilizando o follow-up e reduzindo o tempo de resposta. Resumo da configuração | Componente | Papel no fluxo | Exemplo de uso | | :--- | :--- | :--- | | Flow (Flows/Chatbot) | Sequência visual de ações executada para cada contato que atende ao gatilho. | Flow chamado “Alerta de novo lead”. | | Gatilho “Contato criado” | Inicia o fluxo automaticamente quando um novo contato é salvo no CRM. | Contato criado via importação, manualmente ou por integração. | | Ação de envio de e-mail | Dispara o e-mail de notificação com os dados do lead. | Mensagem com nome, telefone, e-mail e origem do contato. | | Variáveis do contato | Campos dinâmicos que personalizam o conteúdo do e-mail. | {{ contact.first_name }}, {{ contact.phone }}, {{ contact.source }}. | Como funciona: passo a passo 1. Crie o Flow com o gatilho adequado No painel da Papo, acesse o módulo Flows / Chatbot. Inicie um novo Flow e dê um nome como “Notificação de novo lead”. No editor, substitua o gatilho padrão pelo evento Contato criado — ele está disponível na lista de eventos do módulo Flows. Assim, o fluxo será executado toda vez que um novo registro de contato for inserido no CRM, independentemente da origem. 2. Configure a ação de envio de e-mail Após o gatilho, clique no “+” e escolha a ação de envio de e-mail. Selecione a caixa de entrada de e-mail que será usada como remetente (você precisa ter uma caixa configurada em Configurações → Caixas de entrada). No campo de destinatário, insira o endereço de e-mail do time de vendas ou de um grupo de distribuição. No assunto e no corpo da mensagem, utilize as variáveis do contato para incluir automaticamente as informações do lead. Exemplo de corpo: Novo lead recebido: Nome: {{ contact.first_name }} {{ contact.last_name }} Telefone: {{ contact.phone }} E-mail: {{ contact.email }} Origem: {{ contact.source }} Data de criação: {{ contact.created_at }} Você pode também adicionar uma saudação ou instruções para o time. 3. Ajuste as condições (opcional) Se desejar notificar apenas um grupo específico de vendedores ou leads de determinada origem, insira uma condição antes do envio do e-mail. Por exemplo, verifique se a tag do contato é “lead quente” ou se a origem é “site”. Assim, o e-mail é enviado apenas para os leads que atendem ao critério. 4. Ative o Flow Revise a sequência, salve e altere o status do Flow para Ativo. A partir desse momento, todo novo contato criado no CRM disparará automaticamente o fluxo, enviando o e-mail de notificação. Para quem essa automação é indicada? - Times de vendas que precisam ser notificados em tempo real sobre novos leads, sem depender de verificações manuais no CRM. - Empresas que captam leads por formulários, landing pages ou importação de listas e desejam acelerar o primeiro contato. - Operações B2B que trabalham com prospecção ativa e querem que o vendedor receba um resumo do lead assim que o cadastro é concluído. - Negócios que utilizam a Papo como hub central de contatos e desejam automatizar o alerta de novos registros, independentemente do canal de entrada. Perguntas frequentes Preciso ter uma caixa de e-mail configurada na Papo para enviar as notificações? Sim. É necessário ter pelo menos uma caixa de entrada de e-mail ativa na plataforma. Você pode configurá-la em Configurações → Caixas de entrada, adicionando uma conta de e-mail que será usada como remetente das notificações. Posso enviar o e-mail para múltiplos destinatários? Sim, você pode inserir vários endereços de e-mail no campo de destinatário, separados por vírgula, ou utilizar um endereço de grupo de distribuição. Também é possível criar diferentes ações de e-mail no mesmo Flow para notificar equipes distintas com base em condições. O Flow funciona para contatos importados em massa? Sim. Cada contato incluído via importação dispara o fluxo individualmente. Dessa forma, uma lista inteira de leads gera uma notificação por e-mail para cada novo registro. Como incluir informações personalizadas do lead no corpo do e-mail? Utilize as variáveis de contato disponíveis no editor do Flow. Campos como nome, telefone, e-mail, origem e data de criação podem ser inseridos dinamicamente usando a sintaxe {{ contact.campo }}. A plataforma exibe a lista de variáveis disponíveis durante a edição da mensagem. É possível personalizar o remetente do e-mail de notificação? Sim, o remetente será a caixa de entrada de e-mail que você selecionar na ação de envio. Você pode configurar diferentes caixas com nomes e endereços distintos, conforme a necessidade da sua operação. O que acontece se o e-mail de notificação não for entregue? A Papo registra o status de envio no histórico do contato. Caso ocorra uma falha de entrega, você pode verificar o log de erros no módulo de relatórios ou no próprio Flow. Para detalhes sobre políticas de reenvio e limites, consulte a documentação da plataforma. Leia também - Como programar o envio automático de relatórios de conversas por e‑mail - Como gerenciar seus contatos no CRM da Papo: busca, criação e atualização Comece grátis agora → Centralize canais, automatize notificações e acelere o follow-up de leads com a Papo.