Visão Geral
A API da Morada.ai permite que parceiros integrem seus sistemas para criar e gerenciar deals, enviar notificações, ingerir leads e consultar produtos. A comunicação é feita via REST com payloads JSON.Base URLs
| Ambiente | URL |
|---|---|
| Gateway Principal | https://mia-gateway.morada.ai |
| Integração (Logs) | https://mia-integration.morada.ai/api/v1 |
| Plataforma (Talk) | https://app.morada.ai |
Autenticação
A API utiliza dois métodos de autenticação dependendo do endpoint:API Key
Para endpoints de integração (deals, notificações, leads, produtos), envie a chave no header:Bearer Token
Para endpoints do Talk (autenticação, tickets), envie o token no header:Formato de Resposta
Todas as respostas são retornadas em formato JSON. Em caso de sucesso, o status HTTP será200, 201 ou 202. Em caso de erro:
Códigos de Erro Comuns
| Código | Descrição |
|---|---|
400 | Requisição inválida — verifique os parâmetros enviados |
401 | Não autorizado — API key ou token inválido |
404 | Recurso não encontrado |
500 | Erro interno do servidor |
Próximos Passos
Criar Deal
Crie um novo deal e inicie uma conversa no WhatsApp.
Enviar Notificação
Envie mensagens de template via WhatsApp.