Integrações: ações, webhooks e API

Com o pacote Integrações: - Ações: o assistente consulta o sistema do cliente (pedido, agenda, estoque, segunda via) e executa operações (criar pedido, agendar, cancelar) só depois do Confirmar do contato. Ficam na aba Ações do chatbot. Para proteger o sistema do cliente, há tetos: 15 chamadas por minuto em cada conversa, 600 por minuto no chatbot e, no mês, 10 vezes a cota do chatbot (no mínimo 1.000). Ao bater um teto, o assistente pede para tentar de novo em um minuto (no teto do mês, oferece a equipe), o dono recebe um e-mail e a aba Ações mostra o aviso. - Webhooks: o sistema do cliente recebe os eventos (mensagem recebida, lead, pedido de atendente, fim de roteiro e outros), com assinatura, novas tentativas e reenvio. Ficam em Integrações → Webhooks. No máximo 10 entregas saem ao mesmo tempo para o mesmo webhook (o resto espera na fila). Se o endereço do cliente falha, o dono recebe um e-mail com 1 hora de falhas, outro no segundo dia e outro quando o webhook é desativado (3 dias só de falhas), com o link para reativar. Quando o endereço volta a responder, as entregas pendentes saem logo em seguida. - API: conversas, mensagens (texto, imagem, documento, modelo e botões), contatos, leads, campanhas, lembretes, uso e fontes de conhecimento, com chave em Integrações → Chaves de API. O aviso do momento também pode ser posto e tirado pela API (bom para o sistema da loja avisar uma queda sozinho). Com o pacote Plataforma, a API também cria clientes e chatbots a partir de um modelo, pede o link de conexão do WhatsApp e do Instagram, lista e desconecta canais (o dono recebe um alerta a cada desconexão pela API) e pausa ou retoma o chatbot. O chat do site também abre dentro do app do cliente (numa webview, em tela cheia), com a pessoa identificada pelo mesmo token do site: a documentação tem o passo a passo em "Chat dentro de apps". Em Integrações → Logs ficam as chamadas à API dos últimos 30 dias (a chave, o caminho, o status e o código do erro, sem o corpo), além das chamadas de ações e das entregas de webhooks. A permissão members (desmarcada por padrão) convida e remove a equipe do portal de cada cliente: a tela das chaves mostra quantas pessoas cada chave convidou, com "remover todas", e o dono recebe o resumo diário desses convites e um alerta quando passam de 20 em 24 horas. - Contexto fixo e dados da loja: na aba Ações, cada chatbot pode ter um contexto fixo (por exemplo a loja de uma plataforma, {"loja_id": "42"}), que vai em toda chamada de ação, por cima do contexto do token ou do pareamento, e os dados da loja para a IA (o display da API: nome da unidade, horário, endereço), que o assistente usa como um trecho fixo da base e que não vão para as ações. Só o dono ou um administrador muda, com o segundo fator, e o dono recebe o alerta. - Fontes por contexto: pela API, cada fonte pode ter um contexto (por exemplo o cliente de um SaaS). Ela só vale nas conversas daquele contexto, passa pelo portão e não refaz a análise do chatbot. No painel, a base mostra só quantas são. Em Configurações → Ações, webhooks e API, as abas são Webhooks, Chaves de API e Registros. Cada webhook é uma linha com a situação (Ativo, Falhando desde… ou Desativado), o endereço, quantos eventos, o escopo e a saúde em 24 horas; ao lado, o Testar (manda um evento de teste e mostra a resposta), o Editar (um painel lateral com os eventos em chaves, o escopo e os cabeçalhos) e o "…" (Desativar ou Reativar e Apagar, que perguntam antes). Com falhas na semana, aparece "Reenviar as falhas", com a data. "Novo webhook" e "Nova chave" abrem num modal e mostram o segredo uma vez, com o Copiar. Cada chave é uma linha com a situação, o escopo, as permissões em etiquetas e o último uso; o "…" tem Revogar a chave e Remover quem ela convidou; as revogadas ficam fechadas embaixo. Em Registros, os filtros Chamadas à API, Chamadas de ações e Entregas de webhooks mostram cada um, com a situação em pílula e o corpo ao abrir.

A documentação completa fica em boavoz.com/docs.