Dask

Dask

Integrações, canais, webhooks e API

Conecte provedores e fontes externas pelo fluxo oficial, teste o vínculo e acompanhe a prontidão antes de ativar.

Conhecer a home Contato

Navegação

Onde acessar

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

  • 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. 1. Selecione o provedor: Escolha a integração disponível para o serviço e o objetivo reais.
  2. 2. Autorize a conexão: Conclua OAuth, signup incorporado ou credencial pelo campo protegido oferecido; não cole segredos em descrições.
  3. 3. Selecione recursos e destino: Escolha conta, canal, fonte, coluna, tipo ou escopo quando a tela solicitar.
  4. 4. Configure webhook ou mapeamento: Copie apenas os valores gerados para os campos correspondentes no provedor e relacione os dados recebidos.
  5. 5. Teste e ative: Execute o teste oficial, corrija pendências e ative somente após o estado de prontidão ser confirmado.
  6. 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

Passo a passo

Como conectar o WhatsApp pela Meta

A conexão oficial passa pela autorização da Meta, seleção da conta empresarial e sincronização dos números antes da administração em Canais.

  1. 1. Inicie Conectar Meta: Abra Integrações e comece o fluxo de conexão do WhatsApp.
  2. 2. Autorize a conta: Conclua o cadastro incorporado e selecione a conta empresarial e a WABA corretas.
  3. 3. Sincronize os ativos: Traga os números disponíveis e corrija assinaturas de webhook quando a tela indicar.
  4. 4. Configure em Canais: Defina membros, permissões, notificações e perfil comercial de cada número.

Passo a passo

Como criar, rotacionar ou revogar uma chave da API

Chaves pessoais de acesso são credenciais sensíveis e o valor completo deve ser guardado no momento em que a tela o apresenta.

  1. 1. Abra Dask API: Entre em Integrações e localize as chaves do workspace.
  2. 2. Crie ou rotacione: Informe nome e escopos mínimos necessários e confirme a operação.
  3. 3. Guarde a credencial: Copie o valor exibido uma única vez para um cofre seguro.
  4. 4. Finalize ou revogue: Conclua a rotação depois de migrar o consumidor ou revogue uma chave que não deve mais funcionar.

Passo a passo

Como configurar ActiveCampaign

A conexão precisa validar a credencial, descobrir o schema e salvar os mapeamentos antes de importar ou sincronizar contatos.

  1. 1. Crie a conexão: Informe a conta e a credencial solicitadas e execute o teste.
  2. 2. Descubra os campos: Carregue o schema disponível na conta conectada.
  3. 3. Mapeie e simule: Associe campos e regras de tags e use dry-run antes da aplicação.
  4. 4. Inicie e monitore: Confirme o plano de importação ou sincronização e acompanhe jobs, erros e retries.

Passo a passo

Como configurar e sincronizar Emusys

A conexão Emusys deve ser testada antes de iniciar uma sincronização ou permitir matrículas automatizadas.

  1. 1. Crie a conexão: Informe os dados solicitados e selecione o ambiente correto.
  2. 2. Teste: Valide a credencial armazenada e corrija qualquer falha de acesso.
  3. 3. Inicie a sincronização: Escolha o job oferecido e acompanhe o processamento.
  4. 4. Revise o catálogo: Confira itens importados ou pendentes de revisão antes de usá-los em automações.

Passo a passo

Como administrar um canal de comunicação

Cada número conectado é um canal próprio, com membros, permissões, preferências e perfil comercial independentes.

  1. 1. Abra Canais: Selecione o número empresarial correto.
  2. 2. Atualize o canal: Revise nome, status e visibilidade conforme os controles disponíveis.
  3. 3. Configure as pessoas: Adicione, atualize ou remova membros e defina acesso e notificações do canal.
  4. 4. Sincronize o perfil: Edite o perfil comercial quando permitido e confirme a sincronização com a Meta.