Canais de suporte

Está com algum problema ou dúvida na integração?

Caso precise de auxílio ou tenha alguma dúvida sobre os recursos citados na documentação, entre em contato com nossa equipe de Sucesso de Integrações pelo e-mail abaixo:

📧 [email protected]

Esse é o canal recomendado para dúvidas técnicas relacionadas a integrações com o Asaas, análise de comportamentos inesperados, validação de fluxos e apoio na implementação de recursos via API ou plugins.


Quando utilizar

Utilize os canais de suporte quando precisar de ajuda para:

  • esclarecer dúvidas sobre endpoints, parâmetros, respostas ou erros de API;
  • entender comportamentos de Webhooks;
  • validar fluxos de cobrança, assinatura, Pix, split, Checkout, subcontas ou demais recursos de integração;
  • investigar falhas de comunicação entre sua aplicação e o Asaas;
  • analisar erros de autenticação, permissão, ambiente ou payload;
  • confirmar boas práticas de implementação;
  • obter apoio durante testes em Sandbox;
  • orientar a transição de uma integração para Produção;
  • tratar dúvidas operacionais relacionadas aos plugins oficiais.
📘

Recomendação

Antes de acionar o suporte, consulte a documentação do recurso utilizado e valide se a requisição está sendo enviada no ambiente correto, Sandbox ou Produção.

Isso ajuda a reduzir o tempo de investigação e facilita a identificação da causa do problema.


Canal oficial para suporte técnico

O canal oficial para suporte técnico de integrações é o e-mail:

📧 [email protected]

📘

Horário de atendimento

O atendimento é feito em dias úteis, das 8h às 19h.

O tempo típico de resposta em horário comercial é de 2 horas.

Esse canal deve ser utilizado para dúvidas ou problemas que exigem análise técnica pela equipe de Sucesso de Integrações.


Informações recomendadas no contato

Para agilizar o atendimento, envie o máximo de informações técnicas disponíveis sobre o caso.

Sempre que possível, inclua:

InformaçãoExemplo
Ambiente utilizadoSandbox ou Produção
Endpoint ou recurso afetado/v3/payments, Webhooks, Checkout, plugin WooCommerce
Método HTTPGET, POST, PUT, DELETE
Horário aproximado do erroData, hora e fuso horário
Código HTTP retornado400, 401, 403, 404, 429, 500
Mensagem de erroMensagem retornada pela API
ID do recursopay_..., cus_..., sub_..., quando aplicável
Payload enviadoCorpo da requisição, removendo dados sensíveis
Resposta recebidaRetorno da API, removendo dados sensíveis
Comportamento esperadoO que sua integração esperava que acontecesse
Comportamento observadoO que ocorreu na prática
🚧

Segurança

Nunca envie sua API Key, tokens de autenticação, senhas, dados completos de cartão ou qualquer credencial sensível por e-mail, Discord ou WhatsApp.

Caso precise compartilhar exemplos de payload, remova ou mascare informações sensíveis antes do envio.


O que pode ser tratado pelo suporte de integrações

O time de Sucesso de Integrações pode apoiar em temas como:

  • dúvidas sobre uso da API;
  • análise de erros em requisições;
  • comportamento de Webhooks;
  • validação de payloads;
  • dúvidas sobre Sandbox e Produção;
  • uso de plugins oficiais;
  • orientação sobre boas práticas de integração;
  • entendimento de status, eventos e respostas;
  • análise de fluxos técnicos relacionados a cobranças, clientes, assinaturas, split, Pix, subcontas e demais recursos de integração.

O que pode exigir outro canal

Alguns assuntos podem depender de outros times ou canais de atendimento.

Tipo de solicitaçãoCanal recomendado
Dúvidas técnicas de integraçãoSucesso de Integrações
Dúvidas comerciaisGerente de contas
Solicitações de liberação comercialGerente de contas
Negociação de condições comerciaisGerente de contas
Dúvidas gerais sobre conta AsaasGerente de contas
Participação em comunidade de desenvolvedoresDiscord

Discord

Nosso time também está disponível no Discord.

No entanto, o Discord não é um canal oficial de suporte técnico. As respostas podem demorar mais para serem realizadas, e você também pode receber ajuda de outras pessoas desenvolvedoras que participam da comunidade.

Acesse nosso Discord

Utilize o Discord para:

  • trocar experiências com outras pessoas desenvolvedoras;
  • compartilhar dúvidas gerais;
  • acompanhar discussões da comunidade;
  • buscar orientações não urgentes;
  • encontrar exemplos e boas práticas compartilhadas por outros integradores.
🚧

Importante

Para casos que exigem análise técnica, investigação de erro, validação de conta ou acompanhamento formal, utilize o canal oficial por e-mail.


Contato com gerente de contas

Se a sua dúvida for comercial, ou se envolver alguma solicitação ou liberação que precise ser feita pelo seu gerente de contas, entre em contato pelo WhatsApp:

0800 009 0037

O atendimento pelo WhatsApp está disponível 24 horas.

Esse canal pode ser utilizado para assuntos como:

  • dúvidas comerciais;
  • liberação de funcionalidades;
  • alinhamentos com gerente de contas;
  • análise de condições comerciais;
  • solicitações relacionadas à conta que não sejam estritamente técnicas.

Impactos operacionais para integrações

Ao depender de suporte para investigação ou validação de uma integração, considere alguns impactos operacionais importantes:

  • o tempo típico de resposta em horário comercial é de 2 horas;
  • atendimentos fora do horário comercial podem ter retorno posterior;
  • dúvidas enviadas com poucas informações técnicas podem exigir interações adicionais;
  • problemas em Produção podem impactar vendas, cobranças, repasses, conciliação ou recebimento de Webhooks;
  • falhas de integração devem ser monitoradas também pela própria aplicação integradora;
  • janelas de manutenção, indisponibilidades externas ou instabilidades podem afetar temporariamente fluxos automatizados;
  • canais não oficiais, como Discord, não devem ser usados como único meio para tratar incidentes ou falhas críticas.
📘

Boa prática

Para fluxos críticos, implemente logs, retentativas seguras, monitoramento interno e alertas na sua própria aplicação.

O suporte pode auxiliar na investigação, mas a integração deve estar preparada para lidar com falhas temporárias, respostas inesperadas e reprocessamentos.


Boas práticas antes de acionar o suporte

Antes de abrir um chamado, recomenda-se:

  • confirmar se está utilizando o ambiente correto;
  • validar se a API Key pertence ao ambiente utilizado;
  • revisar permissões da chave de API;
  • conferir se o endpoint, método HTTP e headers estão corretos;
  • verificar se o body está no formato esperado;
  • consultar a documentação do endpoint utilizado;
  • conferir se há Webhooks pendentes, pausados ou com erro;
  • testar novamente a chamada em ferramenta como Postman ou Insomnia;
  • verificar se o erro ocorre em todos os casos ou apenas em um recurso específico;
  • reunir IDs, horários e mensagens de erro antes de enviar o contato.

Exemplo de mensagem para suporte

Ao entrar em contato com Sucesso de Integrações, você pode seguir o modelo abaixo:

Olá, time!

Estamos com uma dúvida/falha no fluxo de integração abaixo:

Ambiente: Sandbox ou Produção
Recurso/endpoint:
Método HTTP:
Horário aproximado:
Código HTTP retornado:
Mensagem de erro:
ID do recurso relacionado:
Comportamento esperado:
Comportamento observado:

Também anexamos o payload e a resposta da API com dados sensíveis mascarados.

Esse formato facilita a análise e reduz a necessidade de novas solicitações de informação.


Resumo dos canais

CanalUso recomendadoObservação
E-mail Sucesso de IntegraçõesSuporte técnico de integraçãoCanal oficial para análise técnica
DiscordComunidade e dúvidas geraisNão é canal oficial de suporte técnico
WhatsApp do gerente de contasDúvidas comerciais e liberaçõesAtendimento 24 horas


Did this page help you?