# Integrações

> Conexão de canais (WhatsApp, Telegram, Instagram, Messenger, e-mail) e integrações de produtividade (Calendário, Cal.com, Webhooks, Notion).

Source: https://waslo.io/pt-BR/docs/integrations · Last updated: 2026-10-16

## Dois tipos de conexão

A página de Integrações do Waslo se divide em dois grupos:

**Canais** — *onde seus clientes te encontram*. Cada canal vira uma nova porta para a IA receber e responder mensagens.

**Integrações** — *o que a sua IA pode fazer com aquela conversa*. Agendamento, sincronização com CRM, importação de leads, fontes de conhecimento.

Abra **Integrations → Marketplace** pela barra lateral.

## Canais

| Canal | Autenticação | Custo para conectar |
|-------|--------------|---------------------|
| WhatsApp (QR) | Leitura de QR | Grátis (primeiro número incluso) |
| WhatsApp Cloud API | Meta App + token | Grátis |
| Telegram | Criar um bot com um toque ou conectar sua própria conta | Grátis |
| Instagram DM | Meta OAuth | Grátis |
| Facebook Messenger | Meta OAuth | Grátis |
| Chat do site | Snippet do widget | Grátis |
| E-mail — Gmail | Google OAuth | Em breve |
| E-mail — Outlook | Microsoft Graph OAuth | Grátis |

**Todos os canais estão incluídos nos dois planos**, sem taxa de ativação. No pré-pago, cada resposta ainda consome créditos; no Growth, as respostas são ilimitadas.

**WhatsApp Cloud API ou QR oficial.** A Cloud API tira o número do app do WhatsApp; o **QR oficial** mantém seu app WhatsApp Business e conecta o mesmo número à API oficial da Meta (também grátis para conectar). Um número se conecta de um jeito só por vez. A partir de 1º de outubro de 2026, a Meta cobra cada resposta que o agente envia por um número oficial — a Meta fatura na sua conta do WhatsApp Business e o Waslo mostra na página de Faturamento. Os tokens de acesso se renovam sozinhos. Veja [Conectando o WhatsApp](/docs/connecting-whatsapp).

Respostas que você mesmo digita, fora do Waslo, podem pausar o agente para aquele cliente. O que conta como uma resposta digitada por você varia de canal para canal — a tabela completa está em [Transferência Humana](/docs/human-handoff).

### Como conectar um canal

1. Abra **Integrations → Marketplace**
2. Clique no card do canal desejado
3. Siga o fluxo do canal (leitura de QR / OAuth / colar bot token etc.)
4. Quando concluído, o canal aparece como "Connected" no marketplace e no filtro de canais da caixa de entrada

## Integrações (produtividade)

Incluídas em todos os planos, sem nada para desbloquear:
- **Knowledge Base** — suba documentos que a IA possa citar
- **Notion** — compartilhe páginas com a integração do Waslo
- **Webhooks CRM** — encaminha cada evento de lead para seu CRM ou Zapier em tempo real
- **Inbound Lead API** — receba leads de campanhas no Facebook, LeadsBridge etc.
- **Notificações no Telegram** — alertas de admin para leads HOT, transferências e palavras-chave
- **Google Calendar** — a IA agenda direto na sua agenda
- **Cal.com** — agenda alternativa com autenticação por API key
- **CSV Lead Import** — importação em massa via planilha
- **Sincronização de loja** — sincronize seu catálogo da Shopify, Salla, Zid ou ikas
- **Sincronização de CRM** — envie leads para o HubSpot

Um complemento pago:
- **Outbound Campaigns** — envios em massa de templates para listas segmentadas. 3.000 créditos uma única vez no pré-pago, incluídas no Growth.

## Personalidade de IA por canal

Depois de conectar um canal, clique nele pela barra lateral (por exemplo **Integrations → Telegram**) para encontrar um painel **AI behaviour**. Lá você define prompts e mensagens de boas-vindas só para aquele canal. Útil quando quer um tom casual no Telegram e formal no e-mail.

Você pode fazer o mesmo de forma centralizada em **AI Agent → AI Personality → Context Selector**, que lista todos os canais conectados e números de WhatsApp em uma página só.

## Notificações no Telegram (avisos para o admin)

Não confunda com o "canal Telegram" — essas notificações são alertas que chegam **no seu próprio celular** quando algo acontece no Waslo.

1. Crie um bot no [@BotFather](https://t.me/BotFather)
2. Pegue o token e o seu `chat_id` pessoal (com [@userinfobot](https://t.me/userinfobot))
3. Cole os dois em **Integrations → Telegram Notifications**

Você passa a receber alertas em leads HOT, pedidos de transferência da IA e quando palavras-chave personalizadas aparecem.

## Webhooks CRM

Envie eventos de leads para qualquer URL (CRM, Zapier, n8n etc.). Configure em **Integrations → Webhooks**.

Eventos enviados: `lead.created`, `lead.classified`, `lead.handoff`, `message.received`, `message.sent`. O `lead.classified` dispara apenas para a etapa mais quente.

Cada requisição traz o header `X-Waslo-Signature: sha256=<hex>` para você validar a assinatura e ter certeza de que veio do Waslo. O segredo compartilhado é exibido na hora da criação do webhook.

## Inbound Lead API

Receba leads de fontes externas via webhook. A URL única está em **Integrations → Webhooks → Inbound**.

Exemplo de JSON:
```json
{
  "phone": "+5511988887777",
  "name": "Sara Souza",
  "source": "facebook_ads",
  "customFields": { "budget": "5000" }
}
```

Se definir um secret de assinatura, também roda validação HMAC.

## Google Calendar / Cal.com

Conecte um (ou os dois) para a IA marcar consultas. Ordem de prioridade: Google Calendar → Cal.com → nenhum.

Depois de conectado, a IA ganha quatro ferramentas: `get_availability`, `book_slot`, `list_upcoming_appointments`, `cancel_appointment`. Os clientes agendam sem sair da conversa.

## Próximos passos

- [Configuração do agente de IA](/docs/ai-agent-configuration)
- [Gerenciamento de leads](/docs/lead-management)
- [Faturamento e planos](/docs/billing-and-plans) — detalhamento do preço em créditos