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:
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çãoAntes 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:
Horário de atendimentoO 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ção | Exemplo |
|---|---|
| Ambiente utilizado | Sandbox ou Produção |
| Endpoint ou recurso afetado | /v3/payments, Webhooks, Checkout, plugin WooCommerce |
| Método HTTP | GET, POST, PUT, DELETE |
| Horário aproximado do erro | Data, hora e fuso horário |
| Código HTTP retornado | 400, 401, 403, 404, 429, 500 |
| Mensagem de erro | Mensagem retornada pela API |
| ID do recurso | pay_..., cus_..., sub_..., quando aplicável |
| Payload enviado | Corpo da requisição, removendo dados sensíveis |
| Resposta recebida | Retorno da API, removendo dados sensíveis |
| Comportamento esperado | O que sua integração esperava que acontecesse |
| Comportamento observado | O que ocorreu na prática |
SegurançaNunca 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ção | Canal recomendado |
|---|---|
| Dúvidas técnicas de integração | Sucesso de Integrações |
| Dúvidas comerciais | Gerente de contas |
| Solicitações de liberação comercial | Gerente de contas |
| Negociação de condições comerciais | Gerente de contas |
| Dúvidas gerais sobre conta Asaas | Gerente de contas |
| Participação em comunidade de desenvolvedores | Discord |
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.
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.
ImportantePara 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áticaPara 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
| Canal | Uso recomendado | Observação |
|---|---|---|
| E-mail Sucesso de Integrações | Suporte técnico de integração | Canal oficial para análise técnica |
| Discord | Comunidade e dúvidas gerais | Não é canal oficial de suporte técnico |
| WhatsApp do gerente de contas | Dúvidas comerciais e liberações | Atendimento 24 horas |
Updated 14 days ago
