Envia uma mensagem de imagem via WhatsApp usando o terminal especificado.

1. Requisição HTTP

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

2. Cabeçalhos

3. Corpo da Requisição (JSON)

{
    "PhoneNumber": "+5537990000000",
    "UrlBase64": "URL da Imagem ou Base64",
    "Message": "Texto opcional"
}
                

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/SendImageMessage \
    --header 'Content-Type: application/json' \
    --header 'UserToken: TokenDoUsuario' \
    --header 'TerminalToken: TokenDoTerminal' \
    --data '{
    "PhoneNumber": "+5537990000000",
    "UrlBase64": "URL da Imagem ou Base64",
    "Message": "Olá, veja a imagem!"
}'
                

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]"
    }
                                    

  • **UrlBase64** em branco ou nulo

    HTTP/1.1 400 Bad Request
    {
        "mensagem": "A imagem é necessária. [UrlBase64]"
    }
                                    

  • **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."
  }