Navegação

Onde acessar

Abra Configurações e escolha Integrações para provedores e fontes externas. Use Canais para os números e memberships de comunicação. A referência pública da API descreve os endpoints disponibilizados para clientes.

Integrações: /w/:workspaceSlug/settings/integrations.
Canais: /w/:workspaceSlug/settings/channels.
Referência pública da API: /documentacao/api.

Funcionalidades

Como as integrações funcionam

Uma integração representa a conexão autorizada com um provedor. Ela pode receber webhooks, sincronizar dados, enviar operações ou fornecer opções a outros módulos, sempre no workspace e na capacidade configurados.

Uma conexão não fica pronta apenas porque credenciais foram informadas. O fluxo pode exigir callback, teste oficial, mapeamento, seleção de conta, canal ou recurso e ativação explícita.

O catálogo atual oferece fluxos próprios para WhatsApp Business, Stripe Connect, ActiveCampaign, Focus NFe, Meta Lead Ads, Google Ads Lead Form, Typeform, Calendly, Dask Forms, Generic Webhook, Dask API e CSV. Zapier, Make e n8n usam os contratos de Dask API ou Generic Webhook indicados na tela, não um aplicativo nativo separado.

WhatsApp Business: autorize a conta Meta, selecione a WABA e sincronize os números antes de administrá-los em Canais.
Stripe Connect e Focus NFe: conclua o onboarding ou a configuração do provedor na área correspondente e acompanhe o status devolvido.
Meta Lead Ads, Google Ads Lead Form, Typeform e Calendly: configure a fonte, o destino e o mapeamento solicitado; o teste de prontidão não deve ser confundido com uma submissão real.
Dask Forms, Generic Webhook, Dask API e CSV: siga o contrato exibido para hospedagem, payload, PAT, segredo ou colunas da importação.
ActiveCampaign: configure credencial, capacidades, modos de verdade e regras de tags conforme os controles publicados.

Passo a passo

Como configurar uma integração

Siga o assistente do provedor exibido e mantenha a conexão inativa até validar o teste.

1. Selecione o provedor: Escolha a integração disponível para o serviço e o objetivo reais.
2. Autorize a conexão: Conclua OAuth, signup incorporado ou credencial pelo campo protegido oferecido; não cole segredos em descrições.
3. Selecione recursos e destino: Escolha conta, canal, fonte, coluna, tipo ou escopo quando a tela solicitar.
4. Configure webhook ou mapeamento: Copie apenas os valores gerados para os campos correspondentes no provedor e relacione os dados recebidos.
5. Teste e ative: Execute o teste oficial, corrija pendências e ative somente após o estado de prontidão ser confirmado.
6. Administre cada número em Canais: Depois da conexão Meta, selecione o número para ressincronizar, editar o perfil comercial, consultar templates da WABA, definir visibilidade, membros, papel, escopo e notificações ou desativar e reativar o canal.

Formulários

Formulários por provedor e administração de Canais

Cada provedor define campos próprios. Segredos são gravados por controles protegidos e não devem reaparecer em texto aberto depois do cadastro.

Canais é a administração operacional dos números já conectados, não outro cadastro de credencial Meta. Selecione um número para consultar e alterar somente as opções que seu papel permite.

Provedor
Serviço externo e adapter correspondente.
Nome da conexão
Identificação reconhecível para os administradores do workspace.
Autorização ou credencialNunca copie o valor para chat, documentação, logs ou campos livres.
Acesso concedido pelo proprietário da conta externa.
Conta, canal ou recurso externo
Identificador selecionado entre opções devolvidas pelo provedor.
URL e chave de webhook
Valores gerados para cadastrar no local exato indicado pelo provedor.
Mapeamento de campos
Relação entre campos externos e destinos válidos do Dask.
Status e prontidão
Indicam configuração, teste, ativação ou erro que exige resolução.
Perfil comercial e catálogo de templates da WABA
Permitem ressincronizar os ativos, editar o perfil quando o canal está conectado e consultar idioma, categoria, aprovação e eventual motivo de rejeição dos templates.
Visibilidade do número
Controla se o canal fica disponível de forma ampla ou restrita aos membros configurados.
Membro, papel e escopo de conversa
Adiciona ou remove pessoas e define o papel e o conjunto de conversas que cada uma pode acessar no canal.
Notificações por pessoa
Configura preferências individuais de notificação e se o membro recebe avisos daquele número.
Desativar ou reativar canal
Altera o estado operacional do número; canais desconectados ou desativados não permitem editar o perfil.

Acesso

Permissões, segredos e efeitos externos

A administração de integrações é restrita. Tokens, chaves, segredos e credenciais nunca devem ser enviados ao frontend fora de controles específicos nem compartilhados com usuários.

Webhooks e operações externas devem usar a conexão do workspace atual, validação, idempotência e auditoria. Um canal de WhatsApp também possui memberships próprias para leitura e resposta no Inbox.

Solução de problemas

Erros comuns

Corrija o estado de prontidão em vez de criar uma segunda conexão para esconder a falha.

A integração informa que ainda precisa de configuração.
Abra os detalhes e conclua exatamente a conta, recurso, destino ou mapeamento indicado.
O teste do webhook não é reconhecido.
Confirme URL, chave, evento, status da fonte e se o teste foi enviado pela conta externa correta.
A conexão perdeu autorização.
Use a ação oficial de reconectar com uma conta autorizada; não exponha nem reutilize credenciais copiadas.

Relacionados

Recursos relacionados

Integrações alimentam captura, comunicação, automações e fiscal.

Inbox e WhatsApp
Use os canais configurados no atendimento. Saiba mais
Captura de leads, formulários e importações
Mapeie entradas externas ao CRM. Saiba mais
Automações
Use adapters externos somente em nodes compatíveis. Saiba mais

Integrações, canais, webhooks e API