Ir para o final dos metadados
Ir para o início dos metadados

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 12 Próxima »

1- URL base API

Ambientes

URL

Produção

https://api.mosia.chat/v1

Homologação

https://api.hmg.mosia.chat/v1

2- Endpoint

Endpoint

Método

Descrição

schedule/register

POST

Método para inserir uma nova agenda de acordo com os parâmetros de entrada.

3- Autenticação

Key

Value

Descrição

Authorization

<TOKEN_API_MOSIA>

Token de autenticação pode ser encontrado na página de configuração de integração com CRM no painel administrativo.

Para obter o TOKEN_API_MOSIA relacionado ao CRM. siga os passos:

  • Acesse a administração do MOSIA, em admin.mosia.chat

  • No menu principal, acesse "Ajustes Gerais" e habilite o CRM;

  • Indique uma URL de CALLBACK e salve as mudanças.

  • Um token será exibido. Este é o token que será utilizado nas integrações destas APIs.

4- Parâmetros envio

Parâmetro

Obrigatório

Tipo

Descrição

data

TRUE

string

 

Data do agendamento “0000-00-00“

especialidadeId

TRUE

string

 

ID da especialidade do médico

especialidadeNome

TRUE

string

Nome da especialidade do médico

hora

TRUE

string

Hora do atendimento “00:00“

idAgenda

TRUE

string

ID da agenda

idChaveUnicaPaciente

TRUE

string

Login do usuário no app

localizadorMensageria

TRUE

string

Localizador mensageria. Este campo deve coincidir com o localizador de mensageria retornado pela sua API de login

pacienteCpf

TRUE

string

CPF do paciente

pacienteEmail

FALSE

string

Email do paciente

pacienteMatricula

TRUE

string

Matrícula do paciente

pacienteNome

TRUE

string

Nome do paciente

pacienteCelular

TRUE

string

Celular do paciente

idChaveUnicaProfissional

TRUE

string

ID do profissional. Este campo deve coincidir com o campo
chaveUnica do objeto “profissional” do retorno da API de agenda médica

profissionalNome

TRUE

string

Nome do profissional

profissionalNumeroConselho

TRUE

string

NR do conselho do profissional

profissionalSiglaConselho

TRUE

string

Sigla do conselho do profissional

profissionalUfConselho

TRUE

string

UF do conselho do profissional

camposPersonalizados

FALSE

array

Array de objetos contendo chave e valor dos campos personalizados. Este campos serão exibidos no emails de lembretes de agenda.

atendimentoSimplificado

FALSE

boolean

Indica que o agendamento será de forma simplificada. Com este modo ativado, não será possível o uso da vídeo chamada, o médico vai iniciar o chamado no Mosia (sem vídeo) para utilizar os recursos como prontuário, prescrições, registro de atendimento, entre outros recursos.

O paciente neste caso não tem a necessidade de ter um login/app instalado.

O contato do médico com o paciente seria por telefone.

5- Body request (JSON).

{
  "data": "2021-01-26",
  "especialidadeId": "01",
  "especialidadeNome": "Cardiologia",
  "hora": "08:20",
  "idAgenda": "R551",
  "idChaveUnicaPaciente": "joao_t@mobilesaude.com.br",
  "localizadorMensageria" : "joao_t@mobilesaude.com.br",
  "pacienteCpf": "0000000000",
  "pacienteEmail": "joao_t@mobilesaude.com.br",
  "pacienteMatricula": "10001010101",
  "pacienteNome": "João T.",
  "pacienteCelular": "2799999999",
  "idChaveUnicaProfissional" : "208",
  "profissionalNome": João T.",
  "profissionalNumeroConselho": "10020",
  "profissionalSiglaConselho": "CRM",
  "profissionalUfConselho": "ES",
  "camposPersonalizados": [           // NÃO OBRIGATÓRIO
      {
          "chave": "Teste",
          "valor": "Valor teste"
      },
      {
          "chave": "Teste 2",
          "valor": "Valor teste 2"
      }
  ],
  "atendimentoSimplificado": false    // NÃO OBRIGATÓRIO
}

6- Retorno com sucesso (200)

{
    "status": true,
    "data": {
        "id": "00677dd7-7191-4793-8854-ae00320ef960",
        "url": "portal.mosia.com.br/teleconsulta?sala=00677dd7-7191-4793..."
    },
    "critical": null,
    "timestamp": "2021-01-19T15:10:10.074Z",
    "msg": "Agenda criada com sucesso."
}

7- Retorno com erro (200)

{
    "status": false,
    "data": {},
    "critical": [
        {
            "COD": 0,
            "DESC": "Agenda já se encontra registrada.",
            "origem": "schedule/register",
            "trace": "",
            "SOLU": null,
            "REAL": null,
            "CONT": null
        }
    ],
    "timestamp": "2021-01-19T15:11:41.975Z",
    "msg": "Agenda já se encontra registrada."
}
  • Sem rótulos