Principal Clientes MATEC

Clientes MATEC

Materiais para consumo dos clientes da MATEC
João Machado - Matec
Por João Machado - Matec and 1 outro
• 13 artigos

Menu lateral da conversa

Tutorial: Menu de Ações da Conversa no Matec Chat 1️⃣ Informações do Contato Nesta seção, você pode visualizar os detalhes do contato, incluindo nome, telefone e e-mail. Caso necessário, copie as informações clicando no ícone ao lado do número de telefone ou e-mail. 2️⃣ Ações Rápidas Aqui, você pode realizar ações diretas na conversa, como: - Enviar mensagem manualmente 🗨️ - Editar informações do contato ✏️ - Mesclar contatos ➡️ - Excluir a conversa 🗑️ 3️⃣ Agente Atribuído O Matec Chat permite a atribuição automática ou manual da conversa a um agente. Caso a conversa esteja atribuída ao BOT, você pode transferi-la para um agente ou a você mesmo, clicando em "Atribuir a mim". 4️⃣ Equipe Atribuída Se necessário, você pode direcionar a conversa para uma equipe específica dentro da sua organização. Basta selecionar a equipe no menu suspenso. 5️⃣ Prioridade Aqui, você pode definir a prioridade da conversa, ajudando os agentes a organizarem melhor o fluxo de atendimento. As opções disponíveis incluem: - Baixa - Média - Alta - Urgente 6️⃣ Etiquetas da Conversa Use etiquetas para categorizar e organizar conversas. Para adicionar uma etiqueta, clique em “+ Adicionar rótulos” e selecione as opções desejadas (Somente administradores podem criar novas etiquetas). 7️⃣ Macros Macros são ações automatizadas que podem ser aplicadas à conversa para agilizar o atendimento. Alguns exemplos incluem: - Enviar Localização 📍 - Enviar Catálogo 📦 Basta ativar a macro desejada para que ela seja executada na conversa. Podem ser criadas macros "privadas", que somente o agente criador pode visualizar, ou públicas, que todos podem visualizar. 8️⃣ Informações e Histórico da Conversa Aqui, você pode acessar detalhes adicionais da conversa, incluindo: - Informações da Conversa: dados complementares sobre o atendimento. - Atributos do Contato: informações adicionais do cliente. - Conversas Anteriores: histórico de interações com o cliente, caso existam, outras conversas do mesmo contato. Esse é um guia rápido para o menu de ações da conversa no Matec Chat. Essas funções ajudam a otimizar o atendimento e garantir que todas as interações sejam gerenciadas de forma eficiente! 🚀

Última atualização em Mar 02, 2025

Campo de Envio de Texto no Matec Chat

Tutorial: Campo de Envio de Texto no Matec Chat O campo de envio de mensagens no Matec Chat permite que os agentes interajam com os clientes de forma eficiente. Ele possui diferentes modos de envio e funcionalidades adicionais para otimizar o atendimento. 1️⃣ Modos de Envio No topo do campo de texto, há duas opções principais: - Responder (público): A resposta será enviada diretamente para o cliente. - Nota Privada: Mensagem interna visível apenas para a equipe, útil para adicionar observações ou coordenar atendimentos sem que o cliente veja. 2️⃣ Escrevendo e Formatando Mensagens - Shift + Enter: Adiciona uma nova linha sem enviar a mensagem. - "/" (barra): Atalho para selecionar uma Resposta Pronta previamente configurada, agilizando o atendimento. 3️⃣ Funcionalidades Extras Abaixo do campo de texto, há botões adicionais para enriquecer as mensagens: - 😊 Emojis: Adicione emojis à mensagem. - 📎 Anexar Arquivo: Envie documentos, imagens ou outros arquivos. - 🎤 Gravar Áudio: Envie mensagens de voz diretamente na conversa. - 📝 Texto rico (rich text): Utiliza editor rich text. - ✏️ Ativar assinatura: Permite assinar a mensagem rapidamente com assinatura pré definida. - 🧠 Assistente de IA: Abre um assistente de IA para auxiliar nas respostas. 4️⃣ Enviando a Mensagem Após digitar o conteúdo desejado, clique no botão azul "Enviar (↩)" ou pressione Enter para enviar a mensagem diretamente ao cliente. Dicas Rápidas ✅ Use Notas Privadas para registrar informações importantes sem que o cliente veja. ✅ Utilize Respostas Prontas para ganhar tempo e manter um padrão de atendimento. ✅ Explore os atalhos e botões adicionais para enriquecer a conversa com arquivos, áudios e formatação de texto. Com essas funcionalidades, o Matec Chat oferece uma experiência mais prática e ágil no atendimento ao cliente! 🚀

Última atualização em Mar 02, 2025

Opções de Finalização no Matec Chat

Tutorial: Opções de Finalização no Matec Chat O botão "Resolver" permite gerenciar o status das conversas, garantindo que nenhuma solicitação fique sem acompanhamento. Ele possui três opções principais: 1️⃣ Resolver ✅ Quando uma conversa é resolvida, significa que o atendimento foi concluído com sucesso e nenhuma ação adicional é necessária. A conversa será arquivada, mas poderá ser reaberta se o cliente responder. Resolvendo o atendimento o robô volta a funcionar para este contato. 2️⃣ Adiar Até ⏳ Esta opção permite agendar um adiamento para retomar a conversa em um momento específico. Útil para casos em que: - O cliente precisa de tempo para tomar uma decisão. - É necessário aguardar uma resposta externa antes de continuar o atendimento. Ao selecionar essa opção, você pode definir uma data e horário para que a conversa retorne à fila automaticamente. 3️⃣ Marcar como Pendente 🕒 Se a conversa ainda precisa de acompanhamento, mas não pode ser resolvida imediatamente, utilize esta opção. - A conversa continua aberta, mas sinalizada como pendente, indicando que precisa de atenção futura. - Isso ajuda a organizar o fluxo de trabalho e evitar que solicitações importantes sejam esquecidas. Quando usar cada opção? ✅ Resolver: Quando o atendimento foi finalizado e não há mais pendências. ✅ Adiar: Quando for necessário retomar a conversa em um momento futuro específico. ✅ Pendente: Quando a conversa ainda precisa de acompanhamento, mas sem um prazo definido. Gerenciar conversas de forma eficiente melhora o fluxo de atendimento e garante que nenhum cliente fique sem resposta! 🚀

Última atualização em Mar 02, 2025

Menu Lateral no Matec Chat

Tutorial: Menu Lateral no Matec Chat O menu lateral do Matec Chat permite navegar rapidamente entre diferentes seções do atendimento, organizando conversas, equipes e rótulos. 1️⃣ Visualizando Atualmente A primeira seção mostra qual ambiente está sendo visualizado. No exemplo, está definido como Matec, indicando que o usuário está dentro desse workspace. Opção disponível somente para quem tem acesso a mais de um ambiente. 2️⃣ Todas as Conversas 🗂️ Essa opção exibe todas as conversas em andamento, independentemente do status ou agente responsável. 3️⃣ Menções @ Aqui são exibidas as conversas nas quais você foi mencionado diretamente, facilitando o acompanhamento de interações importantes. A menção pode ser realizada de qualquer usuário para qualquer usuário, utilizando uma nota privada com o texto @nomeDoAgente 4️⃣ Não Atendidas 📭 Esta aba lista todas as conversas que ainda não foram respondidas, ajudando a priorizar os atendimentos pendentes. Todas as conversas em que a última resposta foi do lado do cliente e não da empresa. 5️⃣ Equipes 👥 As equipes organizam os atendimentos por setores. No exemplo, há duas equipes criadas: - Comercial - Financeiro Caso seja necessário, novas equipes podem ser adicionadas clicando em "+ Nova equipe". 6️⃣ Caixas de Entrada 📩 As caixas de entrada agrupam as mensagens por canais de atendimento. No exemplo, há uma caixa chamada "matec", que representa um canal de WhatsApp. 7️⃣ Rótulos 🏷️ Os rótulos ajudam a classificar e identificar conversas rapidamente. No exemplo, existe um rótulo chamado "sembot". Esses rótulos podem ser aplicados às conversas para facilitar a organização e busca futura. Para criar um novo rótulo, basta clicar em "+ Novo rótulo". Resumo: Como utilizar o menu lateral? ✅ Acompanhe todas as conversas e veja quais estão pendentes. ✅ Acesse rapidamente suas menções para não perder mensagens importantes. ✅ Gerencie equipes e caixas de entrada para organizar o atendimento. ✅ Utilize rótulos para categorizar conversas e facilitar o monitoramento. Com esse menu, a navegação no Matec Chat se torna mais fluida e eficiente, ajudando no gerenciamento das interações! 🚀

Última atualização em Mar 02, 2025

Configurações de Perfil no Matec Chat

Tutorial: Configurações de Perfil no Matec Chat As Configurações de Perfil permitem personalizar sua conta, ajustar preferências de envio de mensagens e definir uma assinatura automática. 1️⃣ Foto de Perfil 📸 Você pode adicionar ou alterar sua foto de perfil para facilitar a identificação na plataforma. Isso é útil para que outros agentes e clientes reconheçam você nas conversas. 2️⃣ Nome e E-mail 📝 - Seu nome completo: Exibe seu nome na conta. - Nome de exibição: Personaliza o nome que será mostrado nas conversas. - Endereço de e-mail: Associado à sua conta para comunicação interna e notificações. Para salvar qualquer alteração, clique no botão "Atualizar Perfil". 3️⃣ Assinatura de Mensagem Pessoal ✍️ Você pode configurar uma assinatura automática que será incluída no final das mensagens enviadas. 💡 Dicas: ✅ Adicione seu nome e cargo para profissionalismo. ✅ Utilize negrito, itálico ou links para personalizar o texto. ✅ Para salvar, clique em "Salvar assinatura de mensagem". 4️⃣ Tecla de Atalho para Enviar Mensagens ⌨️ Aqui, você pode escolher qual atalho utilizar para enviar mensagens no chat: - Enter: Envia a mensagem imediatamente. - Cmd/Ctrl + Enter: Permite quebra de linha antes de enviar. Isso ajuda a ajustar a usabilidade conforme sua preferência. 5️⃣ Notificações 🔔 Nesta seção, você pode ativar/desativar notificações para diferentes eventos, como: - Novas mensagens recebidas. - Menções diretas ao seu usuário. - Conversas atribuídas a você. Isso ajuda a garantir que você nunca perca atualizações importantes. 6️⃣ Segurança e Acesso 🔒 (Caso disponível nas configurações) - Alteração de senha. - Ativação de autenticação de dois fatores (caso esteja disponível). - Gerenciamento de dispositivos conectados à sua conta. Resumo das Configurações ✅ Personalize seu nome, e-mail e foto de perfil. ✅ Crie uma assinatura personalizada para suas mensagens. ✅ Escolha o atalho de envio que melhor se adapta ao seu estilo. ✅ Gerencie notificações para não perder mensagens importantes. ✅ Ajuste configurações de segurança para maior proteção da conta. Com essas configurações, você pode adaptar o Matec Chat às suas preferências e melhorar sua experiência de uso! 🚀

Última atualização em Mar 02, 2025

Relatórios e Análises no Matec Chat 📊

Tutorial: Relatórios e Análises no Matec Chat 📊 O Matec Chat oferece relatórios detalhados sobre o desempenho do atendimento, ajudando a monitorar métricas importantes para a eficiência do suporte. 1️⃣ Visão Geral do Atendimento A tela de Visão Geral apresenta um resumo em tempo real sobre as interações no sistema. Principais Indicadores: - Conversas Abertas: Total de atendimentos em andamento. - Conversas Não Atendidas: Chamados que ainda não foram respondidos. - Conversas Não Atribuídas: Casos sem um agente responsável. - Conversas Pendentes: Interações que aguardam retorno. - Status do Agente: Número de agentes online, ocupados ou offline. 💡 Dica: Monitorar esses indicadores ajuda a distribuir melhor a carga de trabalho entre os agentes. 2️⃣ Tráfego de Conversas O gráfico de tráfego de conversas mostra a distribuição das mensagens ao longo dos dias e horários. 📌 Isso ajuda a identificar padrões, como os horários de maior demanda, permitindo ajustes na equipe para otimizar o atendimento. 3️⃣ Conversas por Agentes Aqui, é possível visualizar a quantidade de conversas abertas por cada agente e quais ainda estão não atendidas. ✅ Isso facilita a redistribuição das demandas e evita sobrecarga em um único atendente. 4️⃣ Relatório de Conversas Na aba de Conversas, os dados são organizados em gráficos, oferecendo uma análise detalhada do atendimento ao longo do tempo. Métricas Principais: 📌 Conversas Totais: Número de atendimentos iniciados. 📌 Mensagens Recebidas: Total de mensagens enviadas pelos clientes. 📌 Mensagens Enviadas: Mensagens enviadas pelos agentes. 📌 Tempo de Primeira Resposta: Tempo médio até o primeiro retorno ao cliente. 📌 Tempo de Resolução: Tempo médio para concluir um atendimento. 📌 Tempo de Espera do Cliente: Quanto tempo os clientes aguardam resposta. 📌 Contagem de Resoluções: Quantidade de atendimentos finalizados. 💡 Dica: Caso os tempos de resposta ou resolução estejam altos, pode ser necessário redistribuir os atendimentos entre os agentes. Este mesmo relatório pode ser verificado no menu lateral, por conversas gerais, por agentes, rótulos, caixas ou equipes. 5️⃣ Exportação e Relatórios de Agentes Na parte superior da tela, há um botão "Baixar Relatórios de Agentes", que permite exportar dados para análise externa. 📊 Isso facilita auditorias e melhorias contínuas no suporte. Resumo ✅ Monitore o volume de conversas e ajuste a equipe conforme a demanda. ✅ Acompanhe o desempenho dos agentes para garantir um atendimento eficiente. ✅ Otimize tempos de resposta e resolução para melhorar a experiência do cliente. ✅ Utilize relatórios para identificar tendências e tomar decisões estratégicas. Com essas análises, o Matec Chat se torna uma ferramenta poderosa para aprimorar a eficiência do atendimento! 🚀

Última atualização em Mar 02, 2025

API Matec Chat

# Documentação da API - Matec Chat Bem-vindo à documentação oficial da API do Matec Chat. Base URL: https://connect.matec.ai/ Todas as requisições exigem autenticação via apikey no cabeçalho da requisição: Headers obrigatórios apikey: SUA_CHAVE_DE_API Content-Type: application/json Solicite o token de API para o suporte da Matec Enviar Mensagem de Texto **POST** `/message/sendText/{{instance}}` Envia uma mensagem de texto para um número de WhatsApp. Parâmetros (body): { "number": "5591999999999", "options": { "delay": 1200, "presence": "composing", "linkPreview": false }, "textMessage": { "text": "Olá! Tudo bem?" } } Enviar PDF por URL **POST** `/message/sendDocument/{{instance}}` Envia um arquivo PDF via URL. Parâmetros (body): { "number": "5591999999999", "documentMessage": { "url": "https://dominio.com.br/arquivo.pdf", "fileName": "arquivo.pdf", "caption": "Segue o documento" } } Enviar Mídia por URL (imagem, áudio ou vídeo) **POST** `/message/sendMedia/{{instance}}` Parâmetros (body): { "number": "5591999999999", "mediaMessage": { "url": "https://dominio.com.br/imagem.jpg", "mimetype": "image/jpeg", "caption": "Aqui está a imagem" } } Enviar Localização **POST** `/message/sendLocation/{{instance}}` Parâmetros (body): { "number": "5591999999999", "locationMessage": { "latitude": "-23.55052", "longitude": "-46.633308", "name": "Endereço" } } Enviar Contato **POST** `/message/sendContact/{{instance}}` Parâmetros (body): { "number": "5591999999999", "contactMessage": { "fullName": "João Silva", "phoneNumber": "5591988888888" } } Enviar Lista **POST** `/message/sendList/{{instance}}` Parâmetros (body): { "number": "5591999999999", "listMessage": { "buttonText": "Ver opções", "description": "Escolha uma opção abaixo:", "sections": [ { "title": "Serviços", "rows": [ {"rowId": "1", "title": "Agendar consulta"}, {"rowId": "2", "title": "Falar com atendente"} ] } ] } } Verificar se é um número de WhatsApp **POST** `/client/checkNumber/{{instance}}` Parâmetros (body): { "number": "5591999999999" } Alterar Status do Atendimento (Pausa BOT) **POST** `/chat/changeStatus/{{instance}}` Parâmetros (body): { "number": "5591999999999", "status": "closed" } Integração com o Chat Base URL: https://chat.matec.ai/api/v1/accounts/:account_id/ Solicite seu account_id com o suporte da Matec. Headers obrigatórios api_access_token: SUA_CHAVE_DE_API Content-Type: application/json Solicite o token de API para o suporte da Matec Respostas Rápidas (Canned Responses) **GET** `/canned_responses` Lista todas as respostas rápidas cadastradas para a conta. **POST** /canned_responses Cria nova resposta rápida Body { "content": "string", "short_code": "string" } Atribuir Conversa (Conversation Assignment) **POST** `/conversations/:id/assignments` Atribui conversa a um agente Body: { "assignee_id": 123 } Etiquetas da Conversa (Conversation Labels) **POST** `/conversations/:id/labels` Body: { "labels": ["prioridade", "vip"] } Atributos Personalizados (Custom Attributes) **PATCH** `/conversations/:id/custom_attributes` Body: { "cpf": "12345678900", "plano": "premium" } Mensagens (Messages) **POST** `/api/v1/accounts/:account_id/conversations/:conversation_id/messages` Body: { "content": "Olá! Como posso ajudar?", "message_type": "outgoing" } Dúvidas? Entre em contato com o suporte da Matec.ia. 💬

Última atualização em Mar 28, 2025

Entendendo o Sistema de Permissões e Níveis de Acesso

Uma gestão de permissões eficiente é fundamental para organizar o fluxo de trabalho da sua equipe, proteger informações sensíveis e garantir que cada colaborador tenha acesso apenas ao que é necessário para realizar suas funções. Em nossa plataforma, a estrutura de permissões foi desenhada para oferecer flexibilidade e controle, permitindo uma administração detalhada dos acessos. Este artigo detalha o funcionamento dos níveis de acesso, o papel das equipes e as melhorias que estão sendo desenvolvidas para aprimorar ainda mais essa gestão. Níveis de Acesso na Plataforma Atualmente, o sistema opera com dois níveis principais de acesso: Administradores e Agentes. Cada um possui um escopo de atuação distinto, conforme detalhado na tabela abaixo. O Papel das Equipes: Foco na Distribuição As equipes (ou times) são uma ferramenta poderosa para a distribuição e o roteamento automático de conversas. Ao criar uma equipe e associar agentes a ela, você pode direcionar novas conversas para esse grupo específico. O sistema, então, atribui o diálogo a um agente daquela equipe que esteja online e disponível (configurável). É crucial entender que, no modelo atual, as equipes funcionam como um filtro de visualização. A sua função é estritamente operacional, focada em organizar o fluxo de entrada de novas conversas. Isso significa que um agente com permissão para visualizar a fila de "não atribuídos" enxergará todas as conversas dessa fila, e não apenas aquelas que poderiam ser de sua equipe. Como Funciona Hoje: Uma Visão Geral A ilustração abaixo demonstra a hierarquia e o fluxo de permissões no sistema atual. O Administrador supervisiona toda a operação, enquanto os Agentes têm seu acesso determinado pelas caixas de entrada e pelas permissões granulares concedidas a eles. Melhorias Futuras: Visibilidade por Equipes Ouvimos atentamente o feedback de nossos clientes e compreendemos a necessidade de um controle de visibilidade mais alinhado à estrutura de equipes. Sabemos que, em operações maiores, permitir que um agente veja apenas as conversas relevantes para o seu time (incluindo as não atribuídas e o histórico) é um passo importante para a organização e a segurança. Nossa equipe de desenvolvimento está trabalhando em uma atualização significativa que implementará a visibilidade de conversas baseada em equipes. O objetivo é que um agente possa ter sua visão restrita apenas às filas e históricos de conversas das equipes das quais faz parte. A implementação desta funcionalidade é complexa, pois exige uma reestruturação profunda na lógica central de permissões da plataforma. Não se trata de um ajuste simples, mas de uma mudança arquitetural que impacta diversas áreas do sistema. Nosso compromisso é garantir que essa nova funcionalidade seja robusta, segura e eficiente. Por conta dessa complexidade técnica, ainda não temos uma data definida para o lançamento desta melhoria. No entanto, ela é tratada como uma alta prioridade e estamos dedicando nossos esforços para disponibilizá-la o mais breve possível, mantendo nosso padrão de qualidade e estabilidade.

Última atualização em Sep 23, 2025

WhatsApp Business – App comum (QRCode) vs. API Oficial (Cloud API)

A Matec utiliza a API oficial da Meta para integrar o WhatsApp aos atendimentos.  Para ajudar nossos clientes a decidir pelo melhor modelo, este artigo explica as diferenças entre o WhatsApp Business App (aquele do QR Code, instalado no celular) e a API Oficial (Cloud API), detalha como funciona a janela de 24 h, explica os tipos de mensagens e templates, mostra exemplos com variáveis, traz links oficiais e destaca as vantagens de utilizar a API.  Ao final, mostramos como integrar a API pelo matec chat e os cuidados para evitar problemas. Observação sobre preços: - Desde 1 de julho de 2025 a Meta adota tarifação por mensagem, cobrando apenas quando um template de marketing, utilitário ou autenticação é entregue .  Mensagens não‑template (texto, imagem, vídeo, etc.) enviadas dentro de uma janela de atendimento continuam sem custo . - https://developers.facebook.com/docs/whatsapp/pricing/#:~:text=etc,open free entry point window - Antes dessa data vigorava a cobrança por conversação de 24 horas e havia uma franquia de 1 000 conversas de serviço grátis por mês , além de conversas iniciadas por anúncios ou botões do Facebook que abriam uma janela gratuita de 72 h .  A partir de 1 nov 2024 as conversas de serviço tornaram‑se gratuitas, e em 1 jul 2025 o modelo mudou para cobrança por mensagem . - As tarifas variam por país e categoria de mensagem (marketing, utilitária ou autenticação).  Para consultar o valor por mensagem no Brasil ou em outros mercados, use a calculadora oficial no site da Meta . - https://business.whatsapp.com/products/platform-pricing#:~:text=,publish our rates for transparency 1.  Diferenças entre o WhatsApp Business App (QRCode) e a API Oficial 1. WhatsApp Business (QRCode) 2. API Oficial (Cloud API) Dependência de aparelho 1. WhatsApp Business (QRCode) 1. Necessário um smartphone com acesso à internet ligado o tempo todo; se a bateria acabar ou o aplicativo fechar, as mensagens podem atrasar ou não chegar . 2. https://faq.whatsapp.com/3398056720476987 << Por que recebi o aviso "Aguardando mensagem. Essa ação pode levar alguns instantes."? 2. API Oficial (Cloud API) 1. Roda em servidores da Meta e do provedor (Matec). Não depende de smartphone; a conexão é direta e confiável. Número de usuários 1. WhatsApp Business (QRCode) 1. O aplicativo só permite um telefone principal e até quatro dispositivos INDIVIDUAIS conectados; uso por vários atendentes simultâneos pode gerar inconsistências. 2. API Oficial (Cloud API) 1. Permite acesso por múltiplos atendentes via sistemas como o matec chat; escalável. Registro de erros 1. WhatsApp Business (QRCode) 1. O WhatsApp Business comum não sinaliza se a mensagem falhar, então não informa o motivo; não há forma de identificar erros de entrega. 2. API Oficial (Cloud API) 1. A API envia webhooks com status de envio, leitura e códigos de erro; é possível auditar e tratar falhas rapidamente, e ter conhecimento que a mensagem não chegou. Confiabilidade 1. WhatsApp Business (QRCode) 1. Sujeita a falhas de conexão do aparelho, dificuldade para atualizar a chave de criptografia de ponta a ponta e mensagens “Aguardando esta mensagem” ou até mesmo não enviar ou receber mensagens . 2. https://faq.whatsapp.com/3398056720476987 << Por que recebi o aviso "Aguardando mensagem. Essa ação pode levar alguns instantes."? 2. API Oficial (Cloud API) 1. As mensagens transitam diretamente pelos servidores do WhatsApp; as chaves de criptografia são gerenciadas pela API, reduzindo quase a 0 falhas de entrega. Automação e integração 1. WhatsApp Business (QRCode) 1. Suporta respostas rápidas e etiquetas, mas não permite automações avançadas e fluxos de com botões interativos e IA generativa (IA Generativa pode causar banimento conforme documentação). 2. https://business.whatsapp.com/products/platform-pricing#:~:text=,publish our rates for transparency 2. API Oficial (Cloud API) 1. Permite automatizar fluxos com botões interativos, IA generativa e sistemas de atendimento omnichannel (matec chat). Escalabilidade e métricas 1. WhatsApp Business (QRCode) 1. Limitado ao uso manual; não há métricas detalhadas de mensagens, qualidade ou limites. 2. API Oficial (Cloud API) 1. Oferece webhooks, métricas de qualidade, análise de envios e limites por hora. Risco de banimento 1. WhatsApp Business (QRCode) 1. Maior risco, pois a Meta proíbe uso de robôs não oficiais, múltiplos usuários no mesmo aparelho e envio em massa; denúncias e bloqueios podem banir o número sem aviso . 2. https://faq.whatsapp.com/5957850900902049 <<< Detalhes dos termos de uso do WhatsApp. 2. API Oficial (Cloud API) 1. Menor risco; o uso é auditado e há métricas de qualidade. Ainda assim, é necessário seguir as políticas de uso, obter opt‑in e evitar spam. Uso indicado 1. WhatsApp Business (QRCode) 1. Individual (pessoa física que utiliza o celular de maneira corporativa) ou testes; não recomendado para operações de atendimento com vários agentes. 2. API Oficial (Cloud API) 1. Empresas que precisam de atendimento profissional, automação e estabilidade. 2.  Janela de atendimento (24 h) Quando um usuário envia uma mensagem para a empresa, abre‑se uma janela de atendimento de 24 horas.  Enquanto essa janela estiver aberta, a empresa pode responder com qualquer tipo de mensagem, inclusive texto, imagens, listas e botões .  Cada nova mensagem do cliente reinicia a contagem da janela .  Se a empresa não responder dentro de 24 h ou a janela fechar, ela só poderá enviar mensagens usando templates aprovados . 3.  Categorias de mensagens e modelos (templates) A API oficial classifica as mensagens em quatro categorias, que determinam quando você pode enviá‑las e se há cobrança: 1. Utility (Utilidade) – notificações transacionais (confirmação de pedido, atualizações de entrega).  Podem ser enviadas a qualquer momento por meio de templates aprovados.  Quando enviadas dentro da janela de 24 h não há custo ; fora da janela há cobrança por mensagem. 2. Marketing – promoções e anúncios.  Sempre precisam de template aprovado e são cobradas por mensagem. Os templates devem ser categorizados como MARKETING ou UTILITY .  Eles são compostos por componentes (cabeçalho, corpo, rodapé e botões) e podem usar variáveis (placeholders {{1}}, {{2}}, etc.) para personalizar o conteúdo .  A seguir um exemplo de template de marketing com variáveis: "category": "MARKETING" "text": "Compre agora até {{1}} e use o código {{2}} para obter {{3}} de desconto em todos os produtos.", Os parâmetros podem ser posicionais ({{1}}, {{2}}, etc.) ou nomeados (ex.: {{order_code}}) .  No matec chat os campos variáveis podem ser preenchidos manualmente ao enviar a mensagem. 4.  Preços e cobrança - Cobrança por mensagem: desde 1 de julho de 2025, a cobrança ocorre somente quando um template de marketing ou utilidade é entregue .  Respostas utilitárias dentro da janela de 24 h não são cobradas . - Tarifas por país e categoria: as tarifas variam conforme o país e a categoria da mensagem.  Você pode consultar os valores atualizados no rate card oficial . - Mensagens iniciadas pelo cliente: quando o cliente envia a primeira mensagem, abre‑se a janela de 24 h.  As respostas da empresa dentro dessa janela são gratuitas e não consomem templates . 5.  Vantagens da API Oficial 1. Estabilidade e independência de telefone: Como explicado na seção de diferenças, a API funciona diretamente nos servidores da Meta, eliminando a necessidade de um celular ligado o tempo todo e evitando erros de sincronização (“Aguardando esta mensagem” ou falhas por falta de conexão) . 2. Escalabilidade e multi‑usuário: É possível ter vários atendentes trabalhando simultaneamente no matec chat, com registro completo de conversas, controle de permissões e métricas de desempenho SEM RISCOS. 3. Envio de notificações (templates): Você pode programar envios automáticos de confirmação de pedidos, lembretes e códigos de verificação, com personalização por variáveis SEM RISCOS. 4. Webhooks e relatórios: A API fornece webhooks de entrega, leitura e erros, permitindo integrar com sistemas internos e monitorar cada mensagem enviada.  No aplicativo do QR Code isso não é possível. 5. Menor risco de banimento: Usar a API de forma adequada (com opt‑in, conteúdo relevante e limitação de volume) reduz o a quase 0 risco de bloqueio.  O WhatsApp proíbe automação não autorizada ou envio em massa de mensagens ; pela API você segue as políticas oficiais e tem métricas de qualidade. 6. Comodidade para o cliente: Com a API, o contato aparece como conta comercial verificada; é possível exibir nome e logo, aumentando a credibilidade. 6.  Políticas e termos de utilização Para utilizar o WhatsApp Business Platform você deve seguir a Política de Mensagens e os Termos de Serviço .  Entre os pontos principais: 1. Opt‑in: só é permitido enviar mensagens para quem forneceu o número e consentiu em receber mensagens .  Mantenha registro do consentimento e ofereça opção de cancelamento (opt‑out). 2. Uso de templates: fora da janela de 24 h, as mensagens devem utilizar um template aprovado .  O WhatsApp pode revisar, pausar ou rejeitar templates . 3. Automação e escalonamento: durante a janela de atendimento, você pode usar automação, mas deve disponibilizar formas claras de escalar para um atendente humano . 4. Proibição de spam e fraude: não é permitido confundir ou enganar pessoas, nem enviar mensagens em massa não solicitadas .  O uso de bots não oficiais ou multi‑usuário no aplicativo comum pode resultar em banimento do número . 5. Conteúdo permitido: não utilize mensagens para venda de produtos proibidos (tabaco, armas, drogas), conteúdos ilícitos ou que violem leis locais.  Consulte a política de comércio e os guias de mensageria para mais detalhes . 1. https://business.whatsapp.com/policy#:~:text=WhatsApp%20Business%20Services%20,WhatsApp%20Business%20Terms%20of%20Service 7.  Erros comuns e como evitá‑los 7.1  Mensagens “Aguardando esta mensagem” (aplicativo normal) O aviso “Aguardando esta mensagem. Isto pode levar um tempo” aparece quando a chave de criptografia de ponta a ponta não pôde ser atualizada.  Isso geralmente acontece porque a mensagem falhou ou o remetente reinstalou o WhatsApp, não está usando a versão mais recente ou trocou de dispositivo .  Para resolver: - Peça ao remetente para abrir o WhatsApp e certifiquem‑se de que ambos estão online . - Verifique a conexão de internet (troque entre Wi‑Fi e dados móveis) . - Atualize o WhatsApp para a versão mais recente . - Solicite ao remetente que reenvie a mensagem ou acesse o WhatsApp no dispositivo principal . - Caso utilize o aplicativo comum com QR Code, mantenha o celular principal ligado e conectado; se o aparelho ficar offline por muito tempo, as mensagens podem atrasar ou não chegar. 7.2  Falhas no envio/recebimento (aplicativo normal) No WhatsApp Business App, problemas de conexão, bateria, falta de espaço ou erros de atualização podem impedir o envio ou recepção de mensagens.  Muitas vezes o aplicativo indica que a mensagem foi enviada, mas não há como capturar o erro.  Para reduzir essas falhas: - Use um aparelho confiável: escolha um smartphone com boa performance e mantenha‑o carregado e conectado à internet. - Evite multiusuário: não compartilhe o QR Code com vários atendentes simultaneamente.  O WhatsApp pode interpretar isso como uso não autorizado e banir o número . - Considere migrar para a API: na API oficial, as mensagens são gerenciadas por servidores e erros são reportados via webhooks; não há dependência do aparelho. 7.3  Banimento por uso indevido O WhatsApp proíbe o uso de automação ou envio em massa sem consentimento .  Isso inclui scripts de terceiros para disparo de mensagens, bots não certificados e compartilhar o mesmo número com vários atendentes no aplicativo comum.  Para evitar banimentos: - Utilize apenas a API oficial. - Segmente e personalize as mensagens; evite conteúdo genérico para grandes listas. - Respeite a frequência de envios e os pedidos de opt‑out. - Acompanhe a qualidade do número e as métricas de mensagens no WhatsApp Manager ou através do provedor (Apenas na API Oficial). 8.  Como se cadastrar na API Oficial Para usar a API (Cloud API) é necessário ter um Business Manager verificado e seguir alguns passos.  A Meta oferece um fluxo de Embedded Signup que facilita o processo, principalmente quando integrado ao matec chat.  O resumo dos passos: Você pode conceder acesso a equipe da matec para realizar este processo, consulte o guia no link: https://chat.matec.ai/hc/matec-chat-duvidas/articles/1755821300-conceder-acesso-a-meta-para-matec Importante: uma vez conectado à API, o número deixa de funcionar no aplicativo comum.  Todas as mensagens passarão a trafegar via API e pelo matec chat.  Para reverter, seria necessário remover o número da API e reativá‑lo no WhatsApp Business App (processo sujeito a bloqueio temporário). 9.  Utilizando o WhatsApp no matec chat Depois de concluir o cadastro da API, todas as interações são feitas dentro do matec chat.  No painel de atendimento você poderá: - Receber mensagens de clientes e respondê‑las usando texto, imagens, áudios e botões.  As mensagens de serviço dentro da janela de 24 h não geram custos. - Enviar templates aprovados, preenchendo as variáveis; o matec chat permite selecionar o template e inserir valores.  Quando o template é entregue, a cobrança ocorrerá conforme a categoria. - Criar automações e chatbots para responder perguntas frequentes ou encaminhar para atendentes humanos. - Consultar métricas de atendimento, como tempo de resposta, volume de mensagens e qualidade do número.  Para acompanhar a qualidade do número e limites de envio, acesse também o WhatsApp Manager no Business Manager. 10.  Considerações finais A API Oficial do WhatsApp Business oferece uma solução escalável, confiável e adequada para operações de atendimento profissional.  Ela permite integrar sistemas, automatizar fluxos e garantir conformidade com as políticas do WhatsApp, além de fornecer relatórios detalhados e reduzir o risco de banimento.  Apesar de envolver custos por mensagem (especialmente em templates de marketing e autenticação), as vantagens em estabilidade, automação e imagem profissional compensam. O WhatsApp Business App (QRCode) continua útil para celulares corporativos individuais ou testes, mas apresenta limitações importantes: depende de um único aparelho conectado, não oferece relatórios, possui maior risco de banimento e não permite escalonamento.  Para empresas que valorizam eficiência e qualidade no atendimento, a migração para a API oficial é altamente recomendada.

Última atualização em Sep 23, 2025

Onboarding - 👋 Bem-vindo(a) à Matec!

Estamos muito felizes em iniciar a configuração do seu ambiente. Para darmos início ao Setup, precisamos que você siga os pré-requisitos abaixo: 🔑 Acesso à Conta de Anúncios da Meta (Facebook Business) O que precisamos: Acesso de Administrador à sua conta da Meta (Gerenciador de Negócios). Isso é necessário para criarmos e gerenciarmos ativos de comunicação, como o WhatsApp API, e vinculá-los à forma de pagamento. Ação necessária: Adicione os seguintes e-mails como administradores da sua conta: - 📧 [email protected] - 📧 [email protected] 👉 Passo a passo: Conceder acesso à Meta para Matec 💳 Cartão de Crédito na Conta da Meta O que precisamos: Um cartão de crédito válido cadastrado como forma de pagamento principal. As cobranças pelo uso do WhatsApp API são feitas diretamente pela Meta. Ação necessária: Verifique se há um cartão ativo na sua conta. 👉 Tutorial: Como cadastrar cartão de crédito na Meta 🤖 Conta na OpenAI O que precisamos: Para utilizar a Inteligência Artificial Generativa, é necessário ter uma conta na platform.openai.com. Ação necessária: 1. Crie uma conta em platform.openai.com. 2. Adicione créditos mínimos (ex: $5 USD). 3. Adicione como Owner (Proprietário) os e-mails: - 📧 [email protected] - 📧 [email protected] 👉 Guia: Como criar conta na OpenAI ⚠️ Importante: Não temos acesso a dados de cartão. Os custos são cobrados somente se houver uso da Meta ou OpenAI. 👥 Lista de Usuários da Plataforma O que precisamos: Uma planilha com nome completo e e-mail de cada usuário que usará a plataforma. - Nome Completo - E-mail 📲 Configuração de Canais Defina quais canais serão utilizados: - () WhatsApp – Quantidade de números: ___ - Nome do canal(canais): ___ - Responsável pelo canal: ___ - Telefone do responsável: ___ - Números (WhatsApp): ___ - Número em utilização: - () SIM - Observação: Precisa puxar histórico - Conseguimos apenas importar textos, arquivos de mídia do WhatsApp (fotos, vídeos, arquivos) o meta não permite realizar a importação. - A importação é realizada do histórico máximo de 365 dias (do dia realizado) - Este número deixa de existir no WhatsApp do aparelho celular e permanece apenas no Matec Chat. - () Instagram – Quantidade de contas: ___ - Nome do canal(canais): ___ - Responsável pelo canal: ___ - Telefone do responsável: ___ - Contas Instagram: ___ - () Messenger – Quantidade de contas: ___ - Nome do canal(canais): ___ - Responsável pelo canal: ___ - Telefone do responsável: ___ - Contas Messeger: ___ - () Chat no website – Quantidade de sites: ___ - Nome do canal(canais): ___ - Responsável pelo canal: ___ - Telefone do responsável: ___ - Endereço dos sites: ___ 🔗 Integrações Planejadas (Se existir) - Nome do sistema - Objetivo da integração - Contato para dúvidas e acessos 💬 Gestão de Conversas - Encerrar conversas automaticamente por inatividade? - Tempo para fechamento (ex: 24h). - Mensagem de encerramento automático. Permissões: Os agentes poderão visualizar todas as conversas ou apenas as atribuídas a eles? ⏰ Horários de Funcionamento - Defina os horários de atendimento. - Deseja mensagem automática para clientes que ativarem o canal fora do horário? CSAT (Customer Satisfaction): deseja habilitar pesquisa de satisfação ao encerrar conversas? ⚡ Respostas Prontas São atalhos digitados com “/”. Exemplo: /bom-dia, /horarios. Envie sua lista inicial. 📩 Templates de Mensagem (Meta) Templates permitem envio após a janela de 24h da Meta, úteis para follow-ups, promoções e lembretes. 👉 Diferença: - Respostas Prontas: atalhos internos para os agentes. - Templates: aprovados pela Meta, usados para reabrir conversas fora da janela de 24h. Liste os templates desejados. 📊 SLA (Service Level Agreement) Ajuda a medir performance da equipe. Não bloqueia atendimento, apenas gera indicadores com o tempo de finalização da conversa. Exemplo: - SLA Urgente – 5 minutos - SLA Alto – 15 minutos - SLA Médio – 1 hora - SLA Baixo – 4 horas 🤖 Fluxo de Atendimento Deseja fluxo baseado em botões ou em IA Generativa? Nos conte um pouco mais sobre como deseja o fluxo. 🧠 Treinamento da IA Interna (“Capitão”) Crie uma FAQ com perguntas e respostas frequentes. Quanto mais detalhada a base de conhecimento, mais precisas serão as sugestões da IA para os atendentes. 🚀 E agora? 1. Homologação – Ambiente de testes para validar fluxos. 2. Treinamento – Vídeos e materiais de apoio para equipe. 3. Go-Live – Lançamento oficial para todos os usuários. 4. Acompanhamento – Suporte próximo nos primeiros dias e tira-dúvidas online. ✅ Em breve entraremos em contato para agendar a homologação. Até lá, se tiver dúvidas, estamos à disposição!

Última atualização em Sep 24, 2025