Envia uma mensagem de áudio via WhatsApp usando o terminal especificado.

1. Requisição HTTP

POST https://www.keymessages.com.br/api/terminal/SendAudioMessage
                

2. Cabeçalhos

3. Corpo da Requisição (JSON)

{
    "PhoneNumber": "+5537990000000",
    "Url": "URL do Áudio"
}
                

4. Resposta Exemplo

Retorna HTTP 200 e um JSON confirmando o envio:

{
    "success": true,
    "messageId": "abc123",
    "timestamp": "2025-05-19T13:00:00Z"
}
                

5. Exemplo de cURL

curl --request POST \
    --url https://www.keymessages.com.br/api/terminal/SendAudioMessage \
    --header 'Content-Type: application/json' \
    --header 'UserToken: TokenDoUsuario' \
    --header 'TerminalToken: TokenDoTerminal' \
    --data '{
    "PhoneNumber": "+5537990000000",
    "Url": "URL do Áudio"
}'
                

6. Possíveis Erros

• 401 Unauthorized
  Ocorre quando algum token está ausente, inválido ou há crédito insuficiente:
  • **UserToken** ausente ou vazio

    HTTP/1.1 401 Unauthorized
    {
        "mensagem": "O Token do usuario é necessário. [UserToken]"
    }
                                    

  • **TerminalToken** ausente ou vazio

    HTTP/1.1 401 Unauthorized
    {
        "mensagem": "O Token do terminal é necessário. [TerminalToken]"
    }
                                    

  • **UserToken** inválido (não encontrado no repositório)

    HTTP/1.1 401 Unauthorized
    {
        "mensagem": "O Token do usuario é inválido. [UserToken]"
    }
                                    

  • **TerminalToken** inválido (não pertence ao usuário)

    HTTP/1.1 401 Unauthorized
    {
        "mensagem": "O Token do Terminal é inválido. [TerminalToken]"
    }
                                    

  • Crédito insuficiente para débito

    HTTP/1.1 401 Unauthorized
    {
        "mensagem": "Você não possui crédito(s) suficiente."
    }
                                    

• 400 Bad Request
  Falha na validação do corpo da requisição ou erro no envio:
  • **Body** nulo

    HTTP/1.1 400 Bad Request
    {
        "mensagem": "Os dados para envio é necessário. [Body]"
    }
                                    

  • **PhoneNumber** em branco ou nulo

    HTTP/1.1 400 Bad Request
    {
        "mensagem": "O Telefone Whatsapp é necessário. [PhoneNumber]"
    }
                                    

  • **Url** em branco ou nulo

    HTTP/1.1 400 Bad Request
    {
        "mensagem": "O áudio é necessária. [Url]"
    }
                                    

  • **Erro genérico** durante o envio de mensagem

    HTTP/1.1 400 Bad Request
    {
        "mensagem": "Descrição detalhada do erro interno"
    }
                                    

• 500 Internal Server Error
  Para exceções não tratadas ou falhas inesperadas no servidor:

  HTTP/1.1 500 Internal Server Error
  {
      "mensagem": "Algo deu errado no servidor. Tente novamente mais tarde."
  }