Cadastra um novo contato associado ao usuário autenticado.

1. Requisição HTTP

POST https://www.keymessages.com.br/api/contatos
                

2. Cabeçalhos

3. Corpo da Requisição (JSON)

{
    "Nome": "João da Silva",
    "NumeroWhatsappPais": 55,
    "NumeroWhatsappDDD": 37,
    "NumeroWhatsappNumero": "998888777",
    "Categoria": "Clientes"
}
                

4. Resposta Exemplo

HTTP/1.1 200 OK
{
    "id": "GUID-do-contato"
}
                

5. Exemplo de cURL

curl --request POST \
    --url https://www.keymessages.com.br/api/contatos \
    --header 'Content-Type: application/json' \
    --header 'UserToken: TokenDoUsuario' \
    --data '{
    "Nome": "João da Silva",
    "NumeroWhatsappPais": 55,
    "NumeroWhatsappDDD": 37,
    "NumeroWhatsappNumero": "998888777",
    "Categoria": "Clientes"
}'
                

6. Possíveis Erros

• 401 Unauthorized
  • UserToken ausente ou vazio

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

  • UserToken inválido

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

• 400 Bad Request Falha na validação do corpo da requisição:
  • Body nulo

    HTTP/1.1 400 Bad Request
    {
        "mensagem": "Os dados do contato são necessários. [Body]"
    }
                                    

  • Nome em branco ou nulo

    HTTP/1.1 400 Bad Request
    {
        "mensagem": "O nome é necessário. [Nome]"
    }
                                    

  • NumeroWhatsappNumero em branco ou nulo

    HTTP/1.1 400 Bad Request
    {
        "mensagem": "O número do WhatsApp é necessário. [NumeroWhatsappNumero]"
    }
                                    

  • Erro genérico durante o cadastro

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

• 500 Internal Server Error

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