Mudanças

Histórico das mudanças na API, da mais recente para a mais antiga. Mudanças que acrescentam campos não quebram integrações existentes.

2026-10-28

• email novo em POST /v1/conversations. Opcional. É convertido para minúsculas, precisa ter formato de e-mail e até 254 caracteres; um valor inválido responde 400 invalid_request. Também é devolvido em POST /v1/conversations e GET /v1/conversations/:id.
• phone normalizado e só informado. O telefone passa a ser guardado como dado informado, em só dígitos, e deixa de ser usado para achar ou juntar contatos. A resposta devolve o valor normalizado (+55 (11) 99999-0000 volta como 5511999990000), e não mais o texto enviado.
• Telefone inválido é ignorado. Um phone que não tem de 8 a 15 dígitos depois de normalizado deixa de ser guardado, e a chamada segue normalmente, sem erro.
• Fim do 409 por dado de contato diferente. Abrir uma conversa para um external_user_id que já existe, com phone ou email diferentes, substitui os dados informados antes. Um name diferente é ignorado se o contato já tem nome. Um telefone igual ao de um contato do WhatsApp deixa de gerar 409 e não altera esse contato. O 409 continua para Idempotency-Key reutilizada com outro conteúdo.
• phone de GET /v1/conversations/:id é só o informado. Um contato que já tinha conversa de WhatsApp antes desta mudança mantém o telefone no WhatsApp, e o GET /v1/conversations/:id dele passa a devolver phone: null, porque o campo agora traz apenas o telefone informado pela API.
• Retenção da identidade pelo último uso. O prazo de retenção do external_user_id passa a contar do último uso (a última conversa aberta ou a última mensagem enviada), e não mais da criação. Uma identidade em uso não perde o histórico e a memória no fim do prazo. Quando uma identidade parada é anonimizada, o telefone e o e-mail informados do contato dela também são apagados.