Criar ou atualizar contatos em lote
https://api.joinotify.com/contacts/batchAté 500 contatos por chamada, cada um criado ou atualizado pelo telefone ou BSUID. A
resposta é 200 mesmo quando linhas falham: o resultado de cada uma vem em results,
na ordem do envio.
Numa atualização, só valores preenchidos sobrescrevem e as tags são somadas. Com
options.optIn, contatos novos nascem com consentimento e existentes só o ganham se
ainda estavam em unknown — um opt-out nunca é desfeito. O lote não dispara webhooks.
Uma API key restrita a alguns números recebe 403: esta operação é da base inteira.
Body Paramsapplication/json
1 obrigatório(s)1 opcional(is)
Os contatos, de 1 a 500. Cada um precisa de phone ou bsuid.
até 500 itens
Obrigatório quando a linha não traz `bsuid` válido — sem nenhum dos dois, a linha volta com status `failed`.
Telefone em formato internacional. Sem código de país, use options.defaultCountry.
máx. 40 caracteres
Obrigatório quando a linha não traz `phone`.
Id do usuário na Meta para a empresa (BSUID), no formato BR.abc123. Usado quando não há telefone.
máx. 160 caracteres
Nome, até 80 caracteres.
máx. 80 caracteres
Sobrenome, até 80 caracteres.
máx. 80 caracteres
Nome completo, quando a planilha não separa: a primeira palavra vira o nome e o resto, o sobrenome. Ignorado se firstName vier.
máx. 160 caracteres
E-mail. Um endereço inválido recusa a linha.
máx. 254 caracteres
Idioma, como pt-BR. Num formato inválido é ignorado, e o contato novo fica com o idioma sugerido pelo telefone.
máx. 10 caracteres
Fuso horário IANA. Um fuso desconhecido é ignorado, sem recusar a linha.
máx. 64 caracteres
Valores dos campos personalizados, pela key de cada campo. O formato é validado pelo tipo do campo.
Nomes de tags. As que não existem são criadas.
até 20 itens
Regras que valem para o lote inteiro.