Tema Escuro
Perguntas Frequentes (FAQ)
Respostas para as dúvidas mais comuns sobre a API do MeChat.
Geral
Como posso começar a usar a API?
Você precisa gerar um token de acesso no painel do MeChat. Acesse Configurações → API e clique em Gerar Token. Veja o guia completo em Como Começar.
Em quais planos a API está disponível?
A API e os Webhooks estão disponíveis nos planos Enterprise e Experts.
Como funciona a autenticação?
Utilizamos Bearer Token para autenticar requisições. Inclua o token no header Authorization de todas as requisições:
bash
curl -X GET "https://chat.mehub.app/api/v1/users" \
-H "Authorization: Bearer seu_token_aqui"Veja mais detalhes em Autenticação.
Existem limites de uso da API?
Sim. Os limites são aplicados por token e calculados por minuto:
| Categoria | Limite |
|---|---|
| Envio de mensagens | 20/min |
| Verificação de número | 10/min |
| Leitura (GET) | 60/min |
| Escrita (POST, PUT, DELETE) | 30/min |
Veja mais detalhes em Limites de Requisições.
O que acontece se eu exceder o limite de requisições?
Suas requisições serão bloqueadas e você receberá um erro 429 Too Many Requests. Aguarde o tempo indicado no campo retry_after da resposta antes de fazer novas requisições.
Erros Comuns
Erro 400 - Bad Request
A requisição está malformada ou contém dados inválidos.
Causas comuns:
- JSON com erro de sintaxe
- Campos obrigatórios faltando
- Tipo de dados incorreto
Solução: Verifique a sintaxe do JSON e os campos obrigatórios do endpoint.
Erro 401 - Unauthorized
Falha na autenticação.
Causas comuns:
- Token não enviado no header
- Token inválido ou expirado
- Token revogado
Solução: Verifique se o header Authorization: Bearer SEU_TOKEN está correto.
Erro 403 - Forbidden
Você não tem permissão para acessar o recurso.
Causas comuns:
- Tentativa de acessar recurso de outra empresa
- API desabilitada para sua conta
- Permissões insuficientes
Solução: Verifique se você tem acesso ao recurso solicitado.
Erro 404 - Not Found
O recurso solicitado não foi encontrado.
Causas comuns:
- URL do endpoint incorreta
- ID do recurso não existe
- Recurso foi deletado
Solução: Verifique a URL e o ID do recurso.
Erro 409 - Conflict
O recurso está em um estado que impede a operação.
Causas comuns:
- Canal desconectado
- Recurso em uso
Solução: Verifique a mensagem de erro e resolva o conflito antes de tentar novamente.
Erro 422 - Validation Error
Os dados enviados não passaram na validação.
Causas comuns:
- E-mail duplicado
- Senha muito curta
- Formato de telefone inválido
Solução: Leia o campo errors da resposta para ver quais campos estão inválidos.
Erro 429 - Too Many Requests
Você excedeu o limite de requisições.
Solução: Aguarde o tempo indicado em retry_after (em segundos) antes de fazer novas requisições.
Erro 500 - Internal Server Error
Erro interno do servidor.
Solução: Tente novamente mais tarde. Se o erro persistir, entre em contato com o suporte.
Webhooks
Como configuro um webhook?
Acesse Configurações → Webhooks no painel do MeChat, clique em Novo Webhook e configure a URL de destino e os eventos desejados. Veja mais em Configuração de Webhooks.
Por que meu webhook não está sendo recebido?
Verifique:
- A URL está acessível publicamente
- A URL usa HTTPS
- O webhook está ativo no painel
- Os eventos desejados estão selecionados
- Seu servidor responde com status 200
Como evitar webhooks duplicados?
Use o campo webhook_id do payload para identificar e ignorar webhooks já processados.
Não encontrou sua resposta?
Entre em contato com nosso suporte:
- E-mail: [email protected]
- Horário: Segunda a Sexta, 9h às 17h30 (Horário de Brasília)