Responder numa conversa
https://api.joinotify.com/inbox/conversations/{id}/messagesManda uma mensagem pelo número da conversa, escolhida por kind:
kind | O quê |
|---|---|
text | Texto livre. Só com a janela de 24 horas aberta |
media | Um arquivo já enviado em POST /inbox/conversations/{id}/media. Só com a janela aberta |
template | Um template aprovado. Reabre a conversa a qualquer momento |
note | Nota interna: fica na conversa, nunca vai para o WhatsApp |
Fora da janela, text e media são recusados antes do envio com
422 window_closed e o windowExpiresAt. A resposta reabre uma conversa fechada ou
adiada e pausa as automações por um tempo, como quando alguém da equipe responde.
Path Params
1 obrigatório(s)
Id da conversa.
Body Paramsapplication/json
1 obrigatório(s)16 condicional(is)7 opcional(is)
O que enviar: text, media (arquivo já enviado), template ou note (nota interna, que não vai para o WhatsApp).
Valores aceitos:textmediatemplatenotereactionforwardlocationcontactslocation_requestbuttonslistcta_url
Obrigatório quando `kind` é `text` ou `note` (1 a 4096 caracteres).
Texto da mensagem ou da nota, até 4096 caracteres. Obrigatório em text e note.
mín. 1 caracteresmáx. 4096 caracteres
Id interno de uma mensagem da conversa, para citar.
Obrigatório quando `kind` é `media`: o `id` devolvido por `POST /inbox/conversations/{id}/media` nesta conversa.
Id do arquivo devolvido por POST /inbox/conversations/{id}/media. Obrigatório em media.
Legenda da mídia, até 1024 caracteres. Não se aplica a áudio.
máx. 1024 caracteres
Obrigatório quando `kind` é `template`.
Id do template no Joinotify ou o id dele na Meta.
Obrigatório quando `kind` é `template` e o template tem variáveis ou cabeçalho de mídia: cada marcador precisa de uma fonte.
De onde vem cada variável do template, preenchida com os dados do contato da conversa. Toda fonte de contato ou campo exige um fallback.
Com kind: media, envia o áudio como mensagem de voz. O arquivo precisa ser OGG.
Obrigatório quando `kind` é `reaction`.
Id interno da mensagem da conversa que recebe a reação (últimos 30 dias).
Obrigatório quando `kind` é `reaction`; vazio (`""`) desfaz a nossa reação.
O emoji da reação. Vazio ("") desfaz a reação.
Obrigatório quando `kind` é `forward`.
Id interno da mensagem a encaminhar.
Obrigatório quando `kind` é `location` (-90 a 90).
Latitude, de -90 a 90.
mín. -90máx. 90
Obrigatório quando `kind` é `location` (-180 a 180).
Longitude, de -180 a 180.
mín. -180máx. 180
Nome do local.
Endereço do local.
Obrigatório quando `kind` é `contacts` (1 a 10 ids de contatos da base).
Ids de contatos da base para enviar como cartões (1 a 10, só os que têm telefone).
até 10 itens
Obrigatório quando `kind` é `location_request`, `buttons`, `list` ou `cta_url`.
Texto principal da mensagem interativa.
Título acima do texto.
Rodapé em letra menor.
Obrigatório quando `kind` é `buttons` (1 a 3 títulos de até 20 caracteres, sem repetir).
Títulos dos botões de resposta: 1 a 3, até 20 caracteres, sem repetir.
até 3 itens
Obrigatório quando `kind` é `list`: o texto do botão que abre a lista (até 20 caracteres).
Texto do botão que abre a lista (até 20 caracteres).
máx. 20 caracteres
Obrigatório quando `kind` é `list` (1 a 10 seções, no máximo 10 linhas somando todas).
Seções da lista: 1 a 10, com no máximo 10 linhas somando todas.
até 10 itens
Obrigatório quando `kind` é `cta_url` (até 20 caracteres).
Texto do botão do link (até 20 caracteres).
máx. 20 caracteres
Obrigatório quando `kind` é `cta_url`: um link `https://`.
Link https:// que o botão abre.