Para Ecommerce

Plugins e Conectores

Leve seu agente para onde seus clientes já estão. O Daguito se integra às plataformas de ecommerce mais usadas e roteia as mensagens recebidas de cada canal para o fluxo que você escolher. Instale um plugin, conecte sua API key e comece a conversar.

Integrações de ecommerce

O Daguito oferece integrações nativas para as três plataformas de loja mais comuns na América Latina e no mundo. Cada uma incorpora o mesmo widget de chat e sincroniza seu catálogo de produtos para que o agente responda com dados reais da sua loja.

WordPress e WooCommerce

O plugin daguito-chat incorpora o agente no seu site WordPress e, se você usa WooCommerce, sincroniza seus produtos para a base de conhecimento do agente.

Durante a instalação, o plugin provisiona um canal de WordPress com um ou dois fluxos de agente (um assistente geral e, se você tiver WooCommerce, um assistente de vendas). Seus produtos do WooCommerce são importados em segundo plano com filas assíncronas, sem travar o painel.

Instalação

1. Sube el plugin a /wp-content/plugins/daguito-chat/
2. Actívalo desde el menú Plugins
3. Ve a Ajustes > Daguito Chat
4. Pega tu API key de daguito.com
5. Listo

Requer WordPress 6.0 ou superior e PHP 7.4 ou superior. A conexão usa application passwords do WordPress para o OAuth.

Três formas de inserir o widget

• Widget flutuante — injetado automaticamente no rodapé de todas as páginas do site.
• Shortcode [daguito-chat] — coloque-o em qualquer página ou post.
• Bloco do Gutenberg — para inseri-lo pelo editor de templates.

O shortcode aceita um parâmetro opcional flow para forçar um fluxo específico naquela página, em vez do fluxo padrão do canal:

[daguito-chat]

[daguito-chat flow="flow_xxxxx"]

Shopify

O app do Daguito para Shopify é instalado via OAuth 2.0. Ao aceitar as permissões, o Daguito provisiona automaticamente um fluxo de agente vinculado ao canal de widget e injeta o script do widget na sua loja.

O widget é entregue como uma Theme App Extension (TAE) que aparece no editor de temas. O lojista a ativa ou desativa em Personalizar → Incorporações de app, sem mexer em código.

Permissões solicitadas

Em produção, o app pede quatro permissões. As duas primeiras são obrigatórias para injetar o widget e ler seu catálogo; as de temas permitem gerenciar a Theme App Extension:

scopes = "write_script_tags,read_products,read_themes,write_themes"

Tiendanube e Nuvemshop

A integração com a Tiendanube (Nuvemshop no Brasil) é apenas no lado do servidor: não há um artefato de plugin para baixar. Após o OAuth, o Daguito injeta o widget na sua loja usando a Scripts API da Tiendanube.

A integração está em conformidade com GDPR e LGPD: trata webhooks de redação da loja, exclusão de clientes e solicitações de dados.

A Tiendanube envia todos os seus eventos (instalação, desinstalação, suspensão e eventos de privacidade) para um único endpoint multiplexado, indicando o tipo de evento no cabeçalho x-linkedstore-event.

O widget web

O widget é um componente de chat em React carregado de forma cross-origin a partir de widget.daguito.com. É o mesmo embed para todas as plataformas: WordPress, Shopify e Tiendanube compartilham exatamente o mesmo widget.

Reutilizar um único widget significa que cada melhoria chega a todas as lojas de uma vez, sem atualizar plugins separadamente.

O que o widget faz

• Resolução de API key — descobre a chave da loja automaticamente ao carregar.
• Sincronização de carrinho — uma ponte com a Shopify mantém o carrinho atualizado durante a conversa (outras plataformas, em breve).
• Busca estruturada — consulta seu catálogo e retorna produtos dentro do chat.
• Design responsivo — otimizado para celular de fábrica.

API do widget

O widget se autentica com uma api_key (não com JWT). Sob o prefixo /api/widget ele expõe os endpoints públicos que movem a conversa:

POST /api/widget/init                  # arranca la sesión y devuelve la config de render
POST /api/widget/message               # envía un mensaje del visitante
POST /api/widget/cart/sync             # sincroniza el carrito (Shopify hoy)
GET  /api/widget/history/:session_id   # recupera el historial de la conversación
POST /api/widget/form-response         # devuelve la respuesta de un formulario

Conectores de canal nativos

Além das lojas, o Daguito recebe mensagens por vários canais e as roteia para o fluxo configurado. Cada canal de entrada usa o mesmo pipeline de ingestão: persistir a mensagem, agrupá-la e executar o fluxo.

Widget

O canal de widget cobre o chat na sua landing page e a integração com ecommerce. É o canal padrão provisionado ao instalar o app do Shopify ou da Tiendanube.

WhatsApp Business API

O conector do WhatsApp recebe mensagens pelo webhook da Graph API da Meta e verifica cada evento antes de processá-lo. O roteamento da mensagem recebida para um fluxo está em desenvolvimento: hoje o webhook valida, registra e normaliza a mensagem, mas a resolução de canal para fluxo ainda está sendo conectada.

Trata texto, imagem, áudio, vídeo, documentos, localização e respostas interativas (listas e botões). Precisa de três variáveis de ambiente:

# Variables de entorno requeridas
WHATSAPP_VERIFY_TOKEN   # cadena que defines en el panel de Meta
WHATSAPP_ACCESS_TOKEN   # token del usuario de sistema, para enviar respuestas
WHATSAPP_APP_SECRET     # App Secret de Meta, para verificar X-Hub-Signature-256

Cada webhook de entrada é verificado com a assinatura X-Hub-Signature-256 (HMAC-SHA256 do corpo bruto usando o App Secret). Se a assinatura não coincidir, a mensagem é rejeitada.

Webhook

O canal de webhook é um gatilho por HTTP POST: qualquer sistema externo pode enviar um evento e iniciar um fluxo. É o caminho para integrações sob medida que não cabem em um plugin existente.

Instalação passo a passo

Um resumo de como colocar cada integração em funcionamento. Em todos os casos você precisa de uma API key da sua conta Daguito.

WordPress

Baixe o plugin, ative-o e cole sua API key em Configurações → Daguito Chat. O plugin cria o fluxo de sincronização e importa seus produtos do WooCommerce automaticamente.

Shopify

Instale o app via OAuth. O Daguito provisiona o fluxo vinculado ao widget e, depois, o lojista ativa o widget no editor de temas (Incorporações de app).

Tiendanube

Inicie a instalação via OAuth. A injeção do widget exige o upload manual do shim no Portal de Partners com a instalação automática ativada.

WhatsApp

Hoje o WhatsApp é configurado no lado do servidor com as variáveis de ambiente (verify token, access token e app secret) e apontando o webhook da Meta para a API do Daguito. O roteamento da mensagem recebida para o seu fluxo ainda está sendo conectado; fale com a gente se quiser ativá-lo.

Roteamento de canais e fluxos

Um canal se conecta a um fluxo por meio da tabela relacional channel_flow_bindings. O canal é a porta de entrada; o fluxo vinculado decide como responder. É assim que os canais de widget e de ecommerce funcionam hoje.

Uma restrição de banco de dados (uniq_channel_flow_bindings_active) garante que haja apenas um fluxo ativo por canal. Trocar de fluxo desativa o anterior e ativa o novo em uma única transação.

Gerenciar canais via API

Pela API de administração você pode listar seus canais com o fluxo ativo e mudar o vínculo ou o estado de cada um:

GET   /api/channels              # lista los canales y su flujo activo
PATCH /api/channels/:channelId   # activa el canal o cambia su flujo enlazado

O que vem agora?