Skip to main content
Coloque estes objetos em configuration.follow_up.actions, na ordem de execução. Cada exemplo é uma action, não uma configuração completa. Uma sequência exige pelo menos uma action de entrega e um finish final, com até 20 actions no total.
send_message exige text e buttons. Use um array vazio para não incluir botões: nesse caso, o texto permite de 1 a 1000 valores escalares Unicode. Com 1 a 3 botões, permite de 1 a 640. Botões de follow-up são apenas de URL, com títulos de 1 a 20 valores escalares e URLs HTTP(S). O clique em uma URL não retoma a sequência.

​
Envie mídia

send_media aceita media_type com valores image, video, audio ou file, com uma url HTTP(S) pública. Mantenha o arquivo acessível até a entrega. A API de criação aceita uma URL, não upload multipart ou base64. A validação estrutural não baixa o arquivo nem verifica tamanho, tipo MIME ou aceitação pelo provedor.

​
Envie um carrossel

Use send_carousel para 1 a 10 cards de imagem, cada um com 1 a 3 botões de URL. O guia de carrosséis inclui todos os campos e um exemplo completo de criação.

​
Peça ao contato para seguir

strict verifica no Instagram se o contato segue a conta; trusted_click confia no clique de confirmação. not_following_message é obrigatório, mas pode ser null. As duas mensagens permitem de 1 a 640 valores escalares; os títulos dos botões, de 1 a 20. max_attempts vai de 1 a 10. recheck_after_seconds vai de 60 a 86400; expires_in_seconds, de 60 a 604800.

​
Peça um endereço de e-mail

​
Peça um número de telefone

As duas actions de captura exigem todos os campos mostrados. message e retry_message permitem de 1 a 1000 valores escalares; max_attempts vai de 1 a 5; expires_in_seconds, de 60 a 604800. A captura valida o valor informado, não sua titularidade, e não envia e-mail ou mensagem de WhatsApp. Em todas as etapas de espera, retry_exhausted_action aceita continue ou stop. A expiração encerra a etapa mesmo quando o esgotamento das tentativas está configurado para continuar. A expiração configurada não estende a permissão do Instagram para enviar mensagens.

​
Adicione uma tag ao contato

Use o UUID de uma tag existente na conta selecionada. Coloque add_contact_tag depois de uma action de entrega. Seu delay_seconds aceita de 0 a 2592000, mas uma mensagem posterior ainda precisa respeitar a validação cumulativa da janela de mensagens.

​
Finalize a sequência

finish aparece exatamente uma vez, no final, e não aceita atraso nem outros campos.

​
Ordem e temporização

Todo follow-up não nulo exige exatamente um botão start_follow_up na abertura, para qualquer tipo de trigger. Etapas de espera vêm antes da entrega. Use no máximo um ask_to_follow; ele não pode ser combinado com captura de e-mail ou telefone. E-mail e telefone podem aparecer uma vez cada, em qualquer ordem. Atrasos de entrega e de etapas de espera são inteiros de 0 a 86399 segundos, relativos à conclusão bem-sucedida anterior. Esperas acumuladas, incluindo atrasos de tags e verificações de follow em segundo plano, precisam manter cada action de envio dentro de 86399 segundos do início aplicável da janela. Uma resposta recebida na captura reinicia essa referência; uma verificação silenciosa de follow não. Filas e o ritmo de envio da conta podem adicionar latência. Uma configuração salva não comprova entrega.