Passar para o conteúdo principal

Como integrar seu sistema com o Monde via API

Conecte o Monde com suas ferramentas e otimize seu trabalho

A integração com a API do Monde permite que você automatize processos e evite retrabalho, utilizando no sistema as informações que já foram preenchidas no seu site ou em outras ferramentas.


O que é possível fazer com a API?

A API do Monde permite:

  • Cadastrar clientes (Pessoas) automaticamente

  • Criar Tarefas para vendedores iniciarem atendimentos

  • Consultar e registrar Cidades


Exemplos de uso

Você pode configurar a integração da forma que fizer mais sentido para sua operação:

  • Criar apenas o cliente no Monde

  • Criar tarefas sem cadastrar o cliente

  • Criar cliente e tarefa ao mesmo tempo

  • Montar fluxos personalizados de acordo com sua necessidade


Como configurar a integração

Para realizar a integração:

  1. Procure um técnico ou desenvolvedor de sua confiança

  2. Compartilhe com ele a documentação da API do Monde

  3. Defina junto como deseja automatizar seu processo

👉 Todas as informações necessárias estão disponíveis na nossa documentação da API.


Explicação Auxiliar - Documentação da API

Como gerar o token de acesso à API

O token de autenticação é obrigatório para utilizar a API.

Ele funciona como uma chave de acesso à sua base no Monde.


Antes de começar

Você precisa ter:

  • Usuário administrador do Monde

  • Senha de acesso ao sistema

  • Endereço do seu servidor Monde

👉 Se não souber o endereço, veja aqui.


Passo a passo

1. Montar o login corretamente

O login deve estar no formato:

usuario@endereco.monde.com.br

Exemplo

paulo.silva@happytours.monde.com.br

2. Acessar o endpoint de autenticação

Método:

POST

Endpoint:

https://SEU-ENDERECO/api/auth/token

3. Inserir os dados

No corpo da requisição (JSON), informe:

{
"username": "seu_usuario@endereco.monde.com.br",
"password": "SUA_SENHA"
}

4. Enviar a requisição

Se estiver tudo correto, você receberá um retorno com o token:

{
"token": "seu_token_aqui"
}

5. Usar o token

Em todas as requisições da API, você deve incluir:

Authorization: Bearer SEU_TOKEN

Importante

  • O token tem validade de 1 hora

  • Apenas usuários administradores podem gerar o token

  • Não compartilhe seu token com terceiros


Erros comuns

  • 401 Unauthorized → login ou senha incorretos

  • 403 Forbidden → usuário não é administrador

  • 404 Not Found → endpoint incorreto


Resumo

Para usar a API do Monde, você precisa:

  1. Ter um usuário administrador

  2. Gerar um token de acesso

  3. Utilizar esse token nas integrações

Respondeu à sua pergunta?