Autenticação

Todas as requisições devem conter o token de autenticação no header:

Authorization: Bearer {SEU_TOKEN}
x-workspace-uuid: {SEU_UUID_WORKSPACE}
Content-Type: application/json

URL Base

Todas as requisições devem ser feitas para a URL base da API:

https://sync-core-api.otima.io/whatsapp/provider

Header (obrigatório)

Todas as requisições exigem envio de token de acesso no header:

• Substitua {SEU_TOKEN} pelo token gerado na plataforma.

• Substitua {SEU_UUID_WORKSPACE} pelo uuid do seu workspace.

Exemplo de Requisição com Header:

curl -X POST https://sync-core-api.otima.io/whatsapp/provider/{NUMERO}/send-message \
  -H "Authorization: Bearer {SEU_TOKEN}" \
  -H "x-workspace-uuid: {SEU_UUID_WORKSPACE}" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "type": "text",
    "text": {
      "body": "Mensagem de teste"
    }
  }'

Erro de Autenticação:

Status Code: 401 Unauthorized

{
  "message": "Autenticação necessária.",
  "details": "Forneça um Bearer Token (Authorization) ou Client Credentials (x-client-id/x-client-secret)."
}

Gerando um token:

Os tokens de acesso são gerados diretamente na plataforma Ótima. Para criar um novo token:

1. Acesse a plataforma e navegue até a área de API tokens através do menu do usuário.

1. Clique em Gerar token.

2. Preencha o Nome do token, escolha um nome descritivo que identifique com exatidão o uso do token (ex: integracao-bm-xxx)

1. Caso queira, você pode definir uma data de validade, caso não seja informada uma data o token nunca irá expirar.

2. Clique em Continuar para gerar o token.

3. Após gerar o token, copie o token e o x-workspace-uuid para começar a utilizar.

Importante

O token será exibido apenas uma vez após a geração. Copie e armazene-o em um local seguro, não será possível visualizá-lo novamente.

Boas práticas

• Não compartilhe tokens entre aplicações diferentes, gere um token separado para cada integração.

• Defina uma validade sempre que possível para limitar a exposição em caso de vazamento.

• Revogue tokens que não estejam mais em uso diretamente na plataforma.